google-api-client 0.42.0 → 0.42.1

data/generated/google/apis/container_v1beta1/representations.rb

@@ -1294,6 +1294,7 @@ module Google
           property :machine_type, as: 'machineType'
           hash :metadata, as: 'metadata'
           property :min_cpu_platform, as: 'minCpuPlatform'
+          property :node_group, as: 'nodeGroup'
           collection :oauth_scopes, as: 'oauthScopes'
           property :preemptible, as: 'preemptible'
           property :reservation_affinity, as: 'reservationAffinity', class: Google::Apis::ContainerV1beta1::ReservationAffinity, decorator: Google::Apis::ContainerV1beta1::ReservationAffinity::Representation
@@ -1806,6 +1807,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :identity_namespace, as: 'identityNamespace'
+          property :identity_provider, as: 'identityProvider'
           property :workload_pool, as: 'workloadPool'
         end
       end

data/generated/google/apis/content_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2
       VERSION = 'V2'
-      REVISION = '20200615'
+      REVISION = '20200702'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'

data/generated/google/apis/content_v2/classes.rb

@@ -9365,7 +9365,7 @@ module Google
         # @return [String]
         attr_accessor :brand
       
-        # Link to the canonical version of the landing page.
+        # URL for the canonical version of your item's landing page.
         # Corresponds to the JSON property `canonicalLink`
         # @return [String]
         attr_accessor :canonical_link
@@ -9619,7 +9619,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :min_handling_time
       
-        # Link to a mobile-optimized version of the landing page.
+        # URL for the mobile-optimized version of your item's landing page.
         # Corresponds to the JSON property `mobileLink`
         # @return [String]
         attr_accessor :mobile_link

data/generated/google/apis/content_v2_1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2_1
       VERSION = 'V2_1'
-      REVISION = '20200617'
+      REVISION = '20200702'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'

data/generated/google/apis/content_v2_1/classes.rb

@@ -8577,7 +8577,7 @@ module Google
         # @return [String]
         attr_accessor :brand
       
-        # Link to the canonical version of the landing page.
+        # URL for the canonical version of your item's landing page.
         # Corresponds to the JSON property `canonicalLink`
         # @return [String]
         attr_accessor :canonical_link
@@ -8794,7 +8794,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :min_handling_time
       
-        # Link to a mobile-optimized version of the landing page.
+        # URL for the mobile-optimized version of your item's landing page.
         # Corresponds to the JSON property `mobileLink`
         # @return [String]
         attr_accessor :mobile_link
@@ -8829,12 +8829,12 @@ module Google
         # @return [Google::Apis::ContentV2_1::Price]
         attr_accessor :price
       
-        # Technical specification or additional product details
+        # Technical specification or additional product details.
         # Corresponds to the JSON property `productDetails`
         # @return [Array<Google::Apis::ContentV2_1::ProductProductDetail>]
         attr_accessor :product_details
       
-        # List of important bullet points describing the product
+        # Bullet points describing the most relevant highlights of a product.
         # Corresponds to the JSON property `productHighlights`
         # @return [Array<String>]
         attr_accessor :product_highlights

data/generated/google/apis/customsearch_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/custom-search/v1/introduction
     module CustomsearchV1
       VERSION = 'V1'
-      REVISION = '20200707'
+      REVISION = '20200715'
     end
   end
 end

data/generated/google/apis/customsearch_v1/service.rb

@@ -256,7 +256,12 @@ module Google
         #   * `"e"`: exclude
         #   * `"i"`: include
         # @param [String] sort
-        #   The sort expression to apply to the results.
+        #   The sort expression to apply to the results. The sort parameter specifies
+        #   that the results be sorted according to the specified expression i.e. sort
+        #   by date.
+        #   [Example:
+        #   sort=date](https://developers.google.com/custom-search/docs/structured_search#
+        #   sort-by-attribute).
         # @param [Fixnum] start
         #   The index of the first result to return. The default number of results per
         #   page is 10, so `&start=11` would start at the top of the second page of
@@ -531,7 +536,12 @@ module Google
         #   * `"e"`: exclude
         #   * `"i"`: include
         # @param [String] sort
-        #   The sort expression to apply to the results.
+        #   The sort expression to apply to the results. The sort parameter specifies
+        #   that the results be sorted according to the specified expression i.e. sort
+        #   by date.
+        #   [Example:
+        #   sort=date](https://developers.google.com/custom-search/docs/structured_search#
+        #   sort-by-attribute).
         # @param [Fixnum] start
         #   The index of the first result to return. The default number of results per
         #   page is 10, so `&start=11` would start at the top of the second page of

data/generated/google/apis/datacatalog_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/data-catalog/docs/
     module DatacatalogV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200618'
+      REVISION = '20200714'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/datacatalog_v1beta1/classes.rb

@@ -583,9 +583,9 @@ module Google
         # display names of the values in this set must not be empty and the display
         # names of the values must be case-insensitively unique within this set.
         # The order of items in this list is preserved. This field can be used to
-        # create, remove and reorder enum values. In order to rename enum value use
-        # RenameTagTemplateFieldEnumValue method. Can have up to 500 allowed
-        # values.
+        # create, remove and reorder enum values. To rename enum values, use the
+        # RenameTagTemplateFieldEnumValue method. This list can include up to 500
+        # allowed values.
         # Corresponds to the JSON property `allowedValues`
         # @return [Array<Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1FieldTypeEnumTypeEnumValue>]
         attr_accessor :allowed_values

data/generated/google/apis/dataflow_v1b3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/dataflow
     module DataflowV1b3
       VERSION = 'V1b3'
-      REVISION = '20200619'
+      REVISION = '20200703'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dataflow_v1b3/service.rb

@@ -528,7 +528,7 @@ module Google
         
         # List the jobs of a project.
         # To list the jobs of a project in a region, we recommend using
-        # `projects.locations.jobs.get` with a [regional endpoint]
+        # `projects.locations.jobs.list` with a [regional endpoint]
         # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To
         # list the all jobs across all regions, use `projects.jobs.aggregated`. Using
         # `projects.jobs.list` is not recommended, as you can only get the list of
@@ -1092,7 +1092,7 @@ module Google
         
         # List the jobs of a project.
         # To list the jobs of a project in a region, we recommend using
-        # `projects.locations.jobs.get` with a [regional endpoint]
+        # `projects.locations.jobs.list` with a [regional endpoint]
         # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To
         # list the all jobs across all regions, use `projects.jobs.aggregated`. Using
         # `projects.jobs.list` is not recommended, as you can only get the list of

data/generated/google/apis/dataproc_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/dataproc/
     module DataprocV1
       VERSION = 'V1'
-      REVISION = '20200619'
+      REVISION = '20200709'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dataproc_v1/classes.rb

@@ -971,13 +971,13 @@ module Google
         attr_accessor :reservation_affinity
       
         # Optional. The Dataproc service account (https://cloud.google.com/dataproc/docs/
-        # concepts/configuring-clusters/service-accounts#
-        # service_accounts_in_cloud_dataproc) (also see VM Data Plane identity (https://
-        # cloud.google.com/dataproc/docs/concepts/iam/dataproc-principals#
-        # vm_service_account_data_plane_identity)) used by Dataproc cluster VM instances
-        # to access Google Cloud Platform services.If not specified, the Compute Engine
-        # default service account (https://cloud.google.com/compute/docs/access/service-
-        # accounts#default_service_account) is used.
+        # concepts/configuring-clusters/service-accounts#service_accounts_in_dataproc) (
+        # also see VM Data Plane identity (https://cloud.google.com/dataproc/docs/
+        # concepts/iam/dataproc-principals#vm_service_account_data_plane_identity)) used
+        # by Dataproc cluster VM instances to access Google Cloud Platform services.If
+        # not specified, the Compute Engine default service account (https://cloud.
+        # google.com/compute/docs/access/service-accounts#default_service_account) is
+        # used.
         # Corresponds to the JSON property `serviceAccount`
         # @return [String]
         attr_accessor :service_account
@@ -2827,8 +2827,8 @@ module Google
       
         # Optional. The version of software inside the cluster. It must be one of the
         # supported Dataproc Versions (https://cloud.google.com/dataproc/docs/concepts/
-        # versioning/dataproc-versions#supported_cloud_dataproc_versions), such as "1.2"
-        # (including a subminor version, such as "1.2.29"), or the "preview" version (
+        # versioning/dataproc-versions#supported_dataproc_versions), such as "1.2" (
+        # including a subminor version, such as "1.2.29"), or the "preview" version (
         # https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#
         # other_versions). If unspecified, it defaults to the latest Debian version.
         # Corresponds to the JSON property `imageVersion`

data/generated/google/apis/dataproc_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/dataproc/
     module DataprocV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20200619'
+      REVISION = '20200709'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dataproc_v1beta2/classes.rb

@@ -977,13 +977,13 @@ module Google
         attr_accessor :reservation_affinity
       
         # Optional. The Dataproc service account (https://cloud.google.com/dataproc/docs/
-        # concepts/configuring-clusters/service-accounts#
-        # service_accounts_in_cloud_dataproc) (also see VM Data Plane identity (https://
-        # cloud.google.com/dataproc/docs/concepts/iam/dataproc-principals#
-        # vm_service_account_data_plane_identity)) used by Dataproc cluster VM instances
-        # to access Google Cloud Platform services.If not specified, the Compute Engine
-        # default service account (https://cloud.google.com/compute/docs/access/service-
-        # accounts#default_service_account) is used.
+        # concepts/configuring-clusters/service-accounts#service_accounts_in_dataproc) (
+        # also see VM Data Plane identity (https://cloud.google.com/dataproc/docs/
+        # concepts/iam/dataproc-principals#vm_service_account_data_plane_identity)) used
+        # by Dataproc cluster VM instances to access Google Cloud Platform services.If
+        # not specified, the Compute Engine default service account (https://cloud.
+        # google.com/compute/docs/access/service-accounts#default_service_account) is
+        # used.
         # Corresponds to the JSON property `serviceAccount`
         # @return [String]
         attr_accessor :service_account
@@ -2897,8 +2897,8 @@ module Google
       
         # Optional. The version of software inside the cluster. It must be one of the
         # supported Dataproc Versions (https://cloud.google.com/dataproc/docs/concepts/
-        # versioning/dataproc-versions#supported_cloud_dataproc_versions), such as "1.2"
-        # (including a subminor version, such as "1.2.29"), or the "preview" version (
+        # versioning/dataproc-versions#supported_dataproc_versions), such as "1.2" (
+        # including a subminor version, such as "1.2.29"), or the "preview" version (
         # https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#
         # other_versions). If unspecified, it defaults to the latest Debian version.
         # Corresponds to the JSON property `imageVersion`

data/generated/google/apis/datastore_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/datastore/
     module DatastoreV1
       VERSION = 'V1'
-      REVISION = '20200510'
+      REVISION = '20200709'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/datastore_v1/classes.rb

@@ -689,7 +689,7 @@ module Google
         end
       end
       
-      # A minimal index definition.
+      # Datastore composite index definition.
       class GoogleDatastoreAdminV1Index
         include Google::Apis::Core::Hashable
       

data/generated/google/apis/displayvideo_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/display-video/
     module DisplayvideoV1
       VERSION = 'V1'
-      REVISION = '20200709'
+      REVISION = '20200714'
 
       # Create, see, edit, and permanently delete your Display & Video 360 entities and reports
       AUTH_DISPLAY_VIDEO = 'https://www.googleapis.com/auth/display-video'

data/generated/google/apis/displayvideo_v1/service.rb

@@ -1693,7 +1693,7 @@ module Google
         #   - `campaignId`
         #   - `insertionOrderId`
         #   - `entityStatus`
-        #   - `lineItemType`.
+        #   - `lineItemType`
         #   Examples:
         #   * All line items under an insertion order: `insertionOrderId="1234"`
         #   * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`
@@ -1707,6 +1707,7 @@ module Google
         #   Acceptable values are:
         #   * "displayName" (default)
         #   * "entityStatus"
+        #   * “flight.dateRange.endDate”
         #   The default sorting order is ascending. To specify descending order for
         #   a field, a suffix "desc" should be added to the field name. Example:
         #   `displayName desc`.

data/generated/google/apis/dlp_v2.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/dlp/docs/
     module DlpV2
       VERSION = 'V2'
-      REVISION = '20200620'
+      REVISION = '20200713'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dlp_v2/classes.rb

@@ -1480,6 +1480,9 @@ module Google
         # Number of characters must be in the range [2, 95].
         # This must be encoded as ASCII.
         # The order of characters does not matter.
+        # The full list of allowed characters is:
+        # <code>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
+        # ~`!@#$%^&*()_-+=`[`]|\:;"'<,>.?/</code>
         # Corresponds to the JSON property `customAlphabet`
         # @return [String]
         attr_accessor :custom_alphabet
@@ -3048,8 +3051,8 @@ module Google
         # Name of the information type. Either a name of your choosing when
         # creating a CustomInfoType, or one of the names listed
         # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
-        # a built-in type. InfoType names should conform to the pattern
-        # `[a-zA-Z0-9_]`1,64``.
+        # a built-in type.  When sending Cloud DLP results to Data Catalog, infoType
+        # names should conform to the pattern `[A-Za-z0-9$-_]`1,64``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

data/generated/google/apis/dns_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see http://developers.google.com/cloud-dns
     module DnsV1
       VERSION = 'V1'
-      REVISION = '20200701'
+      REVISION = '20200709'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dns_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see http://developers.google.com/cloud-dns
     module DnsV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20200625'
+      REVISION = '20200709'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dns_v2beta1.rb

@@ -18,14 +18,14 @@ require 'google/apis/dns_v2beta1/representations.rb'
 
 module Google
   module Apis
-    # Google Cloud DNS API
+    # Cloud DNS API
     #
-    # Configures and serves authoritative DNS records.
+    # 
     #
-    # @see https://developers.google.com/cloud-dns
+    # @see http://developers.google.com/cloud-dns
     module DnsV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200515'
+      REVISION = '20200709'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dns_v2beta1/classes.rb

@@ -22,42 +22,51 @@ module Google
   module Apis
     module DnsV2beta1
       
-      # 
+      # A Change represents a set of ResourceRecordSet additions and deletions
+      # applied atomically to a ManagedZone. ResourceRecordSets within a
+      # ManagedZone are modified by creating a new Change element in the Changes
+      # collection. In turn the Changes collection also records the past
+      # modifications to the ResourceRecordSets in a ManagedZone. The current
+      # state of the ManagedZone is the sum effect of applying all Change
+      # elements in the Changes collection in sequence.
       class Change
         include Google::Apis::Core::Hashable
       
-        # 
+        # Which ResourceRecordSets to add?
         # Corresponds to the JSON property `additions`
         # @return [Array<Google::Apis::DnsV2beta1::ResourceRecordSet>]
         attr_accessor :additions
       
-        # 
+        # Which ResourceRecordSets to remove? Must match existing data exactly.
         # Corresponds to the JSON property `deletions`
         # @return [Array<Google::Apis::DnsV2beta1::ResourceRecordSet>]
         attr_accessor :deletions
       
-        # 
+        # Unique identifier for the resource; defined by the server (output only).
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # 
+        # If the DNS queries for the zone will be served.
         # Corresponds to the JSON property `isServing`
         # @return [Boolean]
         attr_accessor :is_serving
         alias_method :is_serving?, :is_serving
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#change".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The time that this operation was started by the server (output only). This
+        # is in RFC3339 text format.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # 
+        # Status of the operation (output only). A status of "done" means that the
+        # request to update the authoritative servers has been sent, but the
+        # servers might not be updated yet.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -78,16 +87,17 @@ module Google
         end
       end
       
-      # 
+      # The response to a request to enumerate Changes to a ResourceRecordSets
+      # collection.
       class ChangesListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # The requested changes.
         # Corresponds to the JSON property `changes`
         # @return [Array<Google::Apis::DnsV2beta1::Change>]
         attr_accessor :changes
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
@@ -97,7 +107,15 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The presence of this field indicates that there exist more results
+        # following your last page of results in pagination order. To fetch them,
+        # make another list request using this value as your pagination token.
+        # In this way you can retrieve the complete contents of even very large
+        # collections one page at a time. However, if the contents of the collection
+        # change between the first and last paginated list request, the set of all
+        # elements returned will be an inconsistent view of the collection. There is
+        # no way to retrieve a "snapshot" of collections larger than the maximum
+        # page size.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -115,62 +133,78 @@ module Google
         end
       end
       
-      # 
+      # A DNSSEC key pair.
       class DnsKey
         include Google::Apis::Core::Hashable
       
-        # 
+        # String mnemonic specifying the DNSSEC algorithm of this key. Immutable
+        # after creation time.
         # Corresponds to the JSON property `algorithm`
         # @return [String]
         attr_accessor :algorithm
       
-        # 
+        # The time that this resource was created in the control plane. This is in
+        # RFC3339 text format. Output only.
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
       
-        # 
+        # A mutable string of at most 1024 characters associated with this resource
+        # for the user's convenience. Has no effect on the resource's function.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # 
+        # Cryptographic hashes of the DNSKEY resource record associated with this
+        # DnsKey. These digests are needed to construct a DS record that points at
+        # this DNS key. Output only.
         # Corresponds to the JSON property `digests`
         # @return [Array<Google::Apis::DnsV2beta1::DnsKeyDigest>]
         attr_accessor :digests
       
-        # 
+        # Unique identifier for the resource; defined by the server (output only).
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # 
+        # Active keys will be used to sign subsequent changes to the ManagedZone.
+        # Inactive keys will still be present as DNSKEY Resource Records for the use
+        # of resolvers validating existing signatures.
         # Corresponds to the JSON property `isActive`
         # @return [Boolean]
         attr_accessor :is_active
         alias_method :is_active?, :is_active
       
-        # 
+        # Length of the key in bits. Specified at creation time then immutable.
         # Corresponds to the JSON property `keyLength`
         # @return [Fixnum]
         attr_accessor :key_length
       
-        # 
+        # The key tag is a non-cryptographic hash of the a DNSKEY resource record
+        # associated with this DnsKey. The key tag can be used to identify a DNSKEY
+        # more quickly (but it is not a unique identifier). In particular, the key
+        # tag is used in a parent zone's DS record to point at the DNSKEY in this
+        # child ManagedZone. The key tag is a number in the range [0, 65535] and the
+        # algorithm to calculate it is specified in RFC4034 Appendix B. Output only.
         # Corresponds to the JSON property `keyTag`
         # @return [Fixnum]
         attr_accessor :key_tag
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#dnsKey".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # Base64 encoded public half of this key. Output only.
         # Corresponds to the JSON property `publicKey`
         # @return [String]
         attr_accessor :public_key
       
-        # 
+        # One of "KEY_SIGNING" or "ZONE_SIGNING". Keys of type KEY_SIGNING have the
+        # Secure Entry Point flag set and, when active, will be used to sign only
+        # resource record sets of type DNSKEY. Otherwise, the Secure Entry Point
+        # flag will be cleared and this key will be used to sign only resource
+        # record sets of other types. Immutable after creation time.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -199,12 +233,13 @@ module Google
       class DnsKeyDigest
         include Google::Apis::Core::Hashable
       
-        # 
+        # The base-16 encoded bytes of this digest. Suitable for use in a DS
+        # resource record.
         # Corresponds to the JSON property `digest`
         # @return [String]
         attr_accessor :digest
       
-        # 
+        # Specifies the algorithm used to calculate this digest.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -220,27 +255,31 @@ module Google
         end
       end
       
-      # 
+      # Parameters for DnsKey key generation. Used for generating initial keys
+      # for a new ManagedZone and as default when adding a new DnsKey.
       class DnsKeySpec
         include Google::Apis::Core::Hashable
       
-        # 
+        # String mnemonic specifying the DNSSEC algorithm of this key.
         # Corresponds to the JSON property `algorithm`
         # @return [String]
         attr_accessor :algorithm
       
-        # 
+        # Length of the keys in bits.
         # Corresponds to the JSON property `keyLength`
         # @return [Fixnum]
         attr_accessor :key_length
       
-        # 
+        # Specifies whether this is a key signing key (KSK) or a zone signing key
+        # (ZSK). Key signing keys have the Secure Entry Point flag set and, when
+        # active, will only be used to sign resource record sets of type DNSKEY.
+        # Zone signing keys do not have the Secure Entry Point flag set and will be
+        # used to sign all other types of resource record sets.
         # Corresponds to the JSON property `keyType`
         # @return [String]
         attr_accessor :key_type
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # dnsKeySpec".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -258,16 +297,16 @@ module Google
         end
       end
       
-      # 
+      # The response to a request to enumerate DnsKeys in a ManagedZone.
       class DnsKeysListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # The requested resources.
         # Corresponds to the JSON property `dnsKeys`
         # @return [Array<Google::Apis::DnsV2beta1::DnsKey>]
         attr_accessor :dns_keys
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
@@ -277,7 +316,15 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The presence of this field indicates that there exist more results
+        # following your last page of results in pagination order. To fetch them,
+        # make another list request using this value as your pagination token.
+        # In this way you can retrieve the complete contents of even very large
+        # collections one page at a time. However, if the contents of the collection
+        # change between the first and last paginated list request, the set of all
+        # elements returned will be an inconsistent view of the collection. There is
+        # no way to retrieve a "snapshot" of collections larger than the maximum
+        # page size.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -295,82 +342,98 @@ module Google
         end
       end
       
-      # 
+      # A zone is a subtree of the DNS namespace under one administrative
+      # responsibility. A ManagedZone is a resource that represents a DNS zone
+      # hosted by the Cloud DNS service.
       class ManagedZone
         include Google::Apis::Core::Hashable
       
-        # 
+        # The time that this resource was created on the server. This is in RFC3339
+        # text format. Output only.
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
       
-        # 
+        # A mutable string of at most 1024 characters associated with this resource
+        # for the user's convenience. Has no effect on the managed zone's function.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # 
+        # The DNS name of this managed zone, for instance "example.com.".
         # Corresponds to the JSON property `dnsName`
         # @return [String]
         attr_accessor :dns_name
       
-        # 
+        # DNSSEC configuration.
         # Corresponds to the JSON property `dnssecConfig`
         # @return [Google::Apis::DnsV2beta1::ManagedZoneDnsSecConfig]
         attr_accessor :dnssec_config
       
-        # 
+        # The presence for this field indicates that outbound forwarding is enabled
+        # for this zone.  The value of this field contains the set of destinations
+        # to forward to.
         # Corresponds to the JSON property `forwardingConfig`
         # @return [Google::Apis::DnsV2beta1::ManagedZoneForwardingConfig]
         attr_accessor :forwarding_config
       
-        # 
+        # Unique identifier for the resource; defined by the server (output only)
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZone".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # User labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # 
+        # User assigned name for this resource. Must be unique within the project.
+        # The name must be 1-63 characters long, must begin with a letter, end with
+        # a letter or digit, and only contain lowercase letters, digits or dashes.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # 
+        # Optionally specifies the NameServerSet for this ManagedZone. A
+        # NameServerSet is a set of DNS name servers that all host the same
+        # ManagedZones. Most users will leave this field unset.
         # Corresponds to the JSON property `nameServerSet`
         # @return [String]
         attr_accessor :name_server_set
       
-        # 
+        # Delegate your managed_zone to these virtual name servers; defined by the
+        # server (output only)
         # Corresponds to the JSON property `nameServers`
         # @return [Array<String>]
         attr_accessor :name_servers
       
-        # 
+        # The presence of this field indicates that DNS Peering is enabled for this
+        # zone. The value of this field contains the network to peer with.
         # Corresponds to the JSON property `peeringConfig`
         # @return [Google::Apis::DnsV2beta1::ManagedZonePeeringConfig]
         attr_accessor :peering_config
       
-        # 
+        # For privately visible zones, the set of Virtual Private Cloud resources
+        # that the zone is visible from.
         # Corresponds to the JSON property `privateVisibilityConfig`
         # @return [Google::Apis::DnsV2beta1::ManagedZonePrivateVisibilityConfig]
         attr_accessor :private_visibility_config
       
-        # 
+        # The presence of this field indicates that this is a managed reverse
+        # lookup zone and Cloud DNS will resolve reverse lookup queries using
+        # automatically configured records for VPC resources. This only applies
+        # to networks listed under private_visibility_config.
         # Corresponds to the JSON property `reverseLookupConfig`
         # @return [Google::Apis::DnsV2beta1::ManagedZoneReverseLookupConfig]
         attr_accessor :reverse_lookup_config
       
-        # 
+        # The zone's visibility: public zones are exposed to the Internet, while
+        # private zones are visible only to Virtual Private Cloud resources.
         # Corresponds to the JSON property `visibility`
         # @return [String]
         attr_accessor :visibility
@@ -403,23 +466,24 @@ module Google
       class ManagedZoneDnsSecConfig
         include Google::Apis::Core::Hashable
       
-        # 
+        # Specifies parameters for generating initial DnsKeys for this
+        # ManagedZone. Can only be changed while the state is OFF.
         # Corresponds to the JSON property `defaultKeySpecs`
         # @return [Array<Google::Apis::DnsV2beta1::DnsKeySpec>]
         attr_accessor :default_key_specs
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZoneDnsSecConfig".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # Specifies the mechanism for authenticated denial-of-existence responses.
+        # Can only be changed while the state is OFF.
         # Corresponds to the JSON property `nonExistence`
         # @return [String]
         attr_accessor :non_existence
       
-        # 
+        # Specifies whether DNSSEC is enabled, and what mode it is in.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -441,13 +505,14 @@ module Google
       class ManagedZoneForwardingConfig
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZoneForwardingConfig".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # List of target name servers to forward to.
+        # Cloud DNS will select the best available name server if more than one
+        # target is given.
         # Corresponds to the JSON property `targetNameServers`
         # @return [Array<Google::Apis::DnsV2beta1::ManagedZoneForwardingConfigNameServerTarget>]
         attr_accessor :target_name_servers
@@ -467,18 +532,21 @@ module Google
       class ManagedZoneForwardingConfigNameServerTarget
         include Google::Apis::Core::Hashable
       
-        # 
+        # Forwarding path for this NameServerTarget, if unset or set to DEFAULT,
+        # Cloud DNS will make forwarding decision based on address ranges,
+        # i.e. RFC1918 addresses go to the VPC, Non-RFC1918 addresses go to the
+        # Internet. When set to PRIVATE, Cloud DNS will always send queries
+        # through VPC for this target
         # Corresponds to the JSON property `forwardingPath`
         # @return [String]
         attr_accessor :forwarding_path
       
-        # 
+        # IPv4 address of a target name server.
         # Corresponds to the JSON property `ipv4Address`
         # @return [String]
         attr_accessor :ipv4_address
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZoneForwardingConfigNameServerTarget".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -499,22 +567,30 @@ module Google
       class ManagedZoneOperationsListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
       
-        # Type of resource.
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The presence of this field indicates that there exist more results
+        # following your last page of results in pagination order. To fetch them,
+        # make another list request using this value as your page token.
+        # In this way you can retrieve the complete contents of even very large
+        # collections one page at a time. However, if the contents of the collection
+        # change between the first and last paginated list request, the set of all
+        # elements returned will be an inconsistent view of the collection. There is
+        # no way to retrieve a consistent snapshot of a collection larger than the
+        # maximum page size.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # 
+        # The operation resources.
         # Corresponds to the JSON property `operations`
         # @return [Array<Google::Apis::DnsV2beta1::Operation>]
         attr_accessor :operations
@@ -536,13 +612,12 @@ module Google
       class ManagedZonePeeringConfig
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZonePeeringConfig".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The network with which to peer.
         # Corresponds to the JSON property `targetNetwork`
         # @return [Google::Apis::DnsV2beta1::ManagedZonePeeringConfigTargetNetwork]
         attr_accessor :target_network
@@ -562,18 +637,24 @@ module Google
       class ManagedZonePeeringConfigTargetNetwork
         include Google::Apis::Core::Hashable
       
-        # 
+        # The time at which the zone was deactivated, in RFC 3339 date-time
+        # format. An empty string indicates that the peering connection is
+        # active. The producer network can deactivate a zone. The zone is
+        # automatically deactivated if the producer network that the zone
+        # targeted is deleted. Output only.
         # Corresponds to the JSON property `deactivateTime`
         # @return [String]
         attr_accessor :deactivate_time
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZonePeeringConfigTargetNetwork".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The fully qualified URL of the VPC network to forward queries to.
+        # This should be formatted like
+        # https://www.googleapis.com/compute/v1/projects/`project`/global/networks/`
+        # network`
         # Corresponds to the JSON property `networkUrl`
         # @return [String]
         attr_accessor :network_url
@@ -594,13 +675,12 @@ module Google
       class ManagedZonePrivateVisibilityConfig
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZonePrivateVisibilityConfig".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The list of VPC networks that can see this zone.
         # Corresponds to the JSON property `networks`
         # @return [Array<Google::Apis::DnsV2beta1::ManagedZonePrivateVisibilityConfigNetwork>]
         attr_accessor :networks
@@ -620,13 +700,15 @@ module Google
       class ManagedZonePrivateVisibilityConfigNetwork
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZonePrivateVisibilityConfigNetwork".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The fully qualified URL of the VPC network to bind to.
+        # This should be formatted like
+        # https://www.googleapis.com/compute/v1/projects/`project`/global/networks/`
+        # network`
         # Corresponds to the JSON property `networkUrl`
         # @return [String]
         attr_accessor :network_url
@@ -646,8 +728,7 @@ module Google
       class ManagedZoneReverseLookupConfig
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # managedZoneReverseLookupConfig".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -666,7 +747,7 @@ module Google
       class ManagedZonesListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
@@ -676,12 +757,20 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The managed zone resources.
         # Corresponds to the JSON property `managedZones`
         # @return [Array<Google::Apis::DnsV2beta1::ManagedZone>]
         attr_accessor :managed_zones
       
-        # 
+        # The presence of this field indicates that there exist more results
+        # following your last page of results in pagination order. To fetch them,
+        # make another list request using this value as your page token.
+        # In this way you can retrieve the complete contents of even very large
+        # collections one page at a time. However, if the contents of the collection
+        # change between the first and last paginated list request, the set of all
+        # elements returned will be an inconsistent view of the collection. There is
+        # no way to retrieve a consistent snapshot of a collection larger than the
+        # maximum page size.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -699,47 +788,61 @@ module Google
         end
       end
       
-      # 
+      # An operation represents a successful mutation performed on a Cloud DNS
+      # resource.
+      # Operations provide:
+      # - An audit log of server resource mutations.
+      # - A way to recover/retry API calls in the case where the response is never
+      # received by the caller. Use the caller specified client_operation_id.
       class Operation
         include Google::Apis::Core::Hashable
       
-        # 
+        # Only populated if the operation targeted a DnsKey (output only).
         # Corresponds to the JSON property `dnsKeyContext`
         # @return [Google::Apis::DnsV2beta1::OperationDnsKeyContext]
         attr_accessor :dns_key_context
       
-        # 
+        # Unique identifier for the resource. This is the client_operation_id if
+        # the client specified it when the mutation was initiated, otherwise,
+        # it is generated by the server. The name must be 1-63 characters long
+        # and match the regular expression [-a-z0-9]? (output only)
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # operation".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The time that this operation was started by the server. This is in RFC3339
+        # text format (output only).
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # 
+        # Status of the operation. Can be one of the following: "PENDING" or "DONE"
+        # (output only). A status of "DONE" means that the
+        # request to update the authoritative servers has been sent, but the
+        # servers might not be updated yet.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
       
-        # 
+        # Type of the operation. Operations include insert, update, and delete
+        # (output only).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # 
+        # User who requested the operation, for example: user@example.com.
+        # cloud-dns-system for operations automatically done by the system.
+        # (output only)
         # Corresponds to the JSON property `user`
         # @return [String]
         attr_accessor :user
       
-        # 
+        # Only populated if the operation targeted a ManagedZone (output only).
         # Corresponds to the JSON property `zoneContext`
         # @return [Google::Apis::DnsV2beta1::OperationManagedZoneContext]
         attr_accessor :zone_context
@@ -765,12 +868,12 @@ module Google
       class OperationDnsKeyContext
         include Google::Apis::Core::Hashable
       
-        # 
+        # A DNSSEC key pair.
         # Corresponds to the JSON property `newValue`
         # @return [Google::Apis::DnsV2beta1::DnsKey]
         attr_accessor :new_value
       
-        # 
+        # A DNSSEC key pair.
         # Corresponds to the JSON property `oldValue`
         # @return [Google::Apis::DnsV2beta1::DnsKey]
         attr_accessor :old_value
@@ -790,12 +893,16 @@ module Google
       class OperationManagedZoneContext
         include Google::Apis::Core::Hashable
       
-        # 
+        # A zone is a subtree of the DNS namespace under one administrative
+        # responsibility. A ManagedZone is a resource that represents a DNS zone
+        # hosted by the Cloud DNS service.
         # Corresponds to the JSON property `newValue`
         # @return [Google::Apis::DnsV2beta1::ManagedZone]
         attr_accessor :new_value
       
-        # 
+        # A zone is a subtree of the DNS namespace under one administrative
+        # responsibility. A ManagedZone is a resource that represents a DNS zone
+        # hosted by the Cloud DNS service.
         # Corresponds to the JSON property `oldValue`
         # @return [Google::Apis::DnsV2beta1::ManagedZone]
         attr_accessor :old_value
@@ -815,7 +922,7 @@ module Google
       class PoliciesListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
@@ -825,12 +932,20 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The presence of this field indicates that there exist more results
+        # following your last page of results in pagination order. To fetch them,
+        # make another list request using this value as your page token.
+        # In this way you can retrieve the complete contents of even very large
+        # collections one page at a time. However, if the contents of the collection
+        # change between the first and last paginated list request, the set of all
+        # elements returned will be an inconsistent view of the collection. There is
+        # no way to retrieve a consistent snapshot of a collection larger than the
+        # maximum page size.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # 
+        # The policy resources.
         # Corresponds to the JSON property `policies`
         # @return [Array<Google::Apis::DnsV2beta1::Policy>]
         attr_accessor :policies
@@ -852,12 +967,13 @@ module Google
       class PoliciesPatchResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
       
-        # 
+        # A policy is a collection of DNS rules applied to one or more Virtual Private
+        # Cloud resources.
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::DnsV2beta1::Policy]
         attr_accessor :policy
@@ -877,12 +993,13 @@ module Google
       class PoliciesUpdateResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
       
-        # 
+        # A policy is a collection of DNS rules applied to one or more Virtual Private
+        # Cloud resources.
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::DnsV2beta1::Policy]
         attr_accessor :policy
@@ -898,48 +1015,56 @@ module Google
         end
       end
       
-      # 
+      # A policy is a collection of DNS rules applied to one or more Virtual Private
+      # Cloud resources.
       class Policy
         include Google::Apis::Core::Hashable
       
-        # 
+        # Sets an alternative name server for the associated networks. When
+        # specified, all DNS queries are forwarded to a name server that you
+        # choose. Names such as .internal are not available when an alternative
+        # name server is specified.
         # Corresponds to the JSON property `alternativeNameServerConfig`
         # @return [Google::Apis::DnsV2beta1::PolicyAlternativeNameServerConfig]
         attr_accessor :alternative_name_server_config
       
-        # 
+        # A mutable string of at most 1024 characters associated with this resource
+        # for the user's convenience. Has no effect on the policy's function.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # 
+        # Allows networks bound to this policy to receive DNS queries sent by VMs or
+        # applications over VPN connections. When enabled, a virtual IP address will
+        # be allocated from each of the sub-networks that are bound to this policy.
         # Corresponds to the JSON property `enableInboundForwarding`
         # @return [Boolean]
         attr_accessor :enable_inbound_forwarding
         alias_method :enable_inbound_forwarding?, :enable_inbound_forwarding
       
-        # 
+        # Controls whether logging is enabled for the networks bound to this policy.
+        # Defaults to no logging if not set.
         # Corresponds to the JSON property `enableLogging`
         # @return [Boolean]
         attr_accessor :enable_logging
         alias_method :enable_logging?, :enable_logging
       
-        # 
+        # Unique identifier for the resource; defined by the server (output only).
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#policy".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # User assigned name for this policy.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # 
+        # List of network names specifying networks to which this policy is applied.
         # Corresponds to the JSON property `networks`
         # @return [Array<Google::Apis::DnsV2beta1::PolicyNetwork>]
         attr_accessor :networks
@@ -965,13 +1090,15 @@ module Google
       class PolicyAlternativeNameServerConfig
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # policyAlternativeNameServerConfig".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # Sets an alternative name server for the associated networks. When
+        # specified, all DNS queries are forwarded to a name server that you
+        # choose. Names such as .internal are not available when an alternative
+        # name server is specified.
         # Corresponds to the JSON property `targetNameServers`
         # @return [Array<Google::Apis::DnsV2beta1::PolicyAlternativeNameServerConfigTargetNameServer>]
         attr_accessor :target_name_servers
@@ -991,18 +1118,21 @@ module Google
       class PolicyAlternativeNameServerConfigTargetNameServer
         include Google::Apis::Core::Hashable
       
-        # 
+        # Forwarding path for this TargetNameServer, if unset or set to DEFAULT,
+        # Cloud DNS will make forwarding decision based on address ranges,
+        # i.e. RFC1918 addresses go to the VPC, Non-RFC1918 addresses go to the
+        # Internet. When set to PRIVATE, Cloud DNS will always send queries
+        # through VPC for this target
         # Corresponds to the JSON property `forwardingPath`
         # @return [String]
         attr_accessor :forwarding_path
       
-        # 
+        # IPv4 address to forward to.
         # Corresponds to the JSON property `ipv4Address`
         # @return [String]
         attr_accessor :ipv4_address
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # policyAlternativeNameServerConfigTargetNameServer".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1023,13 +1153,15 @@ module Google
       class PolicyNetwork
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # policyNetwork".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The fully qualified URL of the VPC network to bind to.
+        # This should be formatted like
+        # https://www.googleapis.com/compute/v1/projects/`project`/global/networks/`
+        # network`
         # Corresponds to the JSON property `networkUrl`
         # @return [String]
         attr_accessor :network_url
@@ -1045,27 +1177,29 @@ module Google
         end
       end
       
-      # 
+      # A project resource. The project is a top level container for resources
+      # including Cloud DNS ManagedZones. Projects can be created only in the APIs
+      # console.
       class Project
         include Google::Apis::Core::Hashable
       
-        # 
+        # User assigned unique identifier for the resource (output only).
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#project"
-        # .
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # Unique numeric identifier for the resource; defined by the server (output
+        # only).
         # Corresponds to the JSON property `number`
         # @return [Fixnum]
         attr_accessor :number
       
-        # 
+        # Limits associated with a Project.
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::DnsV2beta1::Quota]
         attr_accessor :quota
@@ -1083,81 +1217,86 @@ module Google
         end
       end
       
-      # 
+      # Limits associated with a Project.
       class Quota
         include Google::Apis::Core::Hashable
       
-        # 
+        # Maximum allowed number of DnsKeys per ManagedZone.
         # Corresponds to the JSON property `dnsKeysPerManagedZone`
         # @return [Fixnum]
         attr_accessor :dns_keys_per_managed_zone
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#quota".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # Maximum allowed number of managed zones in the project.
         # Corresponds to the JSON property `managedZones`
         # @return [Fixnum]
         attr_accessor :managed_zones
       
-        # 
+        # Maximum allowed number of managed zones which can be attached to a
+        # network.
         # Corresponds to the JSON property `managedZonesPerNetwork`
         # @return [Fixnum]
         attr_accessor :managed_zones_per_network
       
-        # 
+        # Maximum allowed number of networks to which a privately scoped zone can be
+        # attached.
         # Corresponds to the JSON property `networksPerManagedZone`
         # @return [Fixnum]
         attr_accessor :networks_per_managed_zone
       
-        # 
+        # Maximum allowed number of networks per policy.
         # Corresponds to the JSON property `networksPerPolicy`
         # @return [Fixnum]
         attr_accessor :networks_per_policy
       
-        # 
+        # Maximum allowed number of policies per project.
         # Corresponds to the JSON property `policies`
         # @return [Fixnum]
         attr_accessor :policies
       
-        # 
+        # Maximum allowed number of ResourceRecords per ResourceRecordSet.
         # Corresponds to the JSON property `resourceRecordsPerRrset`
         # @return [Fixnum]
         attr_accessor :resource_records_per_rrset
       
-        # 
+        # Maximum allowed number of ResourceRecordSets to add per
+        # ChangesCreateRequest.
         # Corresponds to the JSON property `rrsetAdditionsPerChange`
         # @return [Fixnum]
         attr_accessor :rrset_additions_per_change
       
-        # 
+        # Maximum allowed number of ResourceRecordSets to delete per
+        # ChangesCreateRequest.
         # Corresponds to the JSON property `rrsetDeletionsPerChange`
         # @return [Fixnum]
         attr_accessor :rrset_deletions_per_change
       
-        # 
+        # Maximum allowed number of ResourceRecordSets per zone in the project.
         # Corresponds to the JSON property `rrsetsPerManagedZone`
         # @return [Fixnum]
         attr_accessor :rrsets_per_managed_zone
       
-        # 
+        # Maximum allowed number of target name servers per managed forwarding zone.
         # Corresponds to the JSON property `targetNameServersPerManagedZone`
         # @return [Fixnum]
         attr_accessor :target_name_servers_per_managed_zone
       
-        # 
+        # Maximum allowed number of alternative target name servers per policy.
         # Corresponds to the JSON property `targetNameServersPerPolicy`
         # @return [Fixnum]
         attr_accessor :target_name_servers_per_policy
       
-        # 
+        # Maximum allowed size for total rrdata in one ChangesCreateRequest in
+        # bytes.
         # Corresponds to the JSON property `totalRrdataSizePerChange`
         # @return [Fixnum]
         attr_accessor :total_rrdata_size_per_change
       
-        # 
+        # DNSSEC algorithm and key length types that can be used for DnsKeys.
         # Corresponds to the JSON property `whitelistedKeySpecs`
         # @return [Array<Google::Apis::DnsV2beta1::DnsKeySpec>]
         attr_accessor :whitelisted_key_specs
@@ -1186,37 +1325,39 @@ module Google
         end
       end
       
-      # 
+      # A unit of data that will be returned by the DNS servers.
       class ResourceRecordSet
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "dns#
-        # resourceRecordSet".
+        # 
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # For example, www.example.com.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # 
+        # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see
+        # <a href="/dns/records/json-record">examples</a>.
         # Corresponds to the JSON property `rrdatas`
         # @return [Array<String>]
         attr_accessor :rrdatas
       
-        # 
+        # As defined in RFC 4034 (section 3.2).
         # Corresponds to the JSON property `signatureRrdatas`
         # @return [Array<String>]
         attr_accessor :signature_rrdatas
       
-        # 
+        # Number of seconds that this ResourceRecordSet can be cached by resolvers.
         # Corresponds to the JSON property `ttl`
         # @return [Fixnum]
         attr_accessor :ttl
       
-        # 
+        # The identifier of a supported record type. See the list of
+        # <a href="/dns/docs/overview#supported_dns_record_types">Supported
+        # DNS record types</a>.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1240,7 +1381,7 @@ module Google
       class ResourceRecordSetsListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV2beta1::ResponseHeader]
         attr_accessor :header
@@ -1250,12 +1391,20 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The presence of this field indicates that there exist more results
+        # following your last page of results in pagination order. To fetch them,
+        # make another list request using this value as your pagination token.
+        # In this way you can retrieve the complete contents of even very large
+        # collections one page at a time. However, if the contents of the collection
+        # change between the first and last paginated list request, the set of all
+        # elements returned will be an inconsistent view of the collection. There is
+        # no way to retrieve a consistent snapshot of a collection larger than the
+        # maximum page size.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # 
+        # The resource record set resources.
         # Corresponds to the JSON property `rrsets`
         # @return [Array<Google::Apis::DnsV2beta1::ResourceRecordSet>]
         attr_accessor :rrsets
@@ -1273,11 +1422,13 @@ module Google
         end
       end
       
-      # 
+      # Elements common to every response.
       class ResponseHeader
         include Google::Apis::Core::Hashable
       
-        # 
+        # For mutating operation requests that completed successfully.
+        # This is the client_operation_id if the client specified it,
+        # otherwise it is generated by the server (output only).
         # Corresponds to the JSON property `operationId`
         # @return [String]
         attr_accessor :operation_id