google-api-client 0.28.7 → 0.29.0

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

@@ -328,6 +328,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2OutputAudioConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2QueryInput
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -358,12 +364,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2Sentiment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowV2SentimentAnalysisRequestConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowV2SentimentAnalysisResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2SessionEntityType
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2SynthesizeSpeechConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2TextInput
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -376,6 +406,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2VoiceSelectionParams
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2WebhookRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -780,6 +816,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :input_audio, :base64 => true, as: 'inputAudio'
+          property :output_audio_config, as: 'outputAudioConfig', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig::Representation
+      
           property :query_input, as: 'queryInput', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2QueryInput, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2QueryInput::Representation
       
           property :query_params, as: 'queryParams', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2QueryParameters, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2QueryParameters::Representation
@@ -790,6 +828,9 @@ module Google
       class GoogleCloudDialogflowV2DetectIntentResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :output_audio, :base64 => true, as: 'outputAudio'
+          property :output_audio_config, as: 'outputAudioConfig', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig::Representation
+      
           property :query_result, as: 'queryResult', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2QueryResult, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2QueryResult::Representation
       
           property :response_id, as: 'responseId'
@@ -863,6 +904,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :audio_encoding, as: 'audioEncoding'
           property :language_code, as: 'languageCode'
+          property :model_variant, as: 'modelVariant'
           collection :phrase_hints, as: 'phraseHints'
           property :sample_rate_hertz, as: 'sampleRateHertz'
         end
@@ -1181,6 +1223,16 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2OutputAudioConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :audio_encoding, as: 'audioEncoding'
+          property :sample_rate_hertz, as: 'sampleRateHertz'
+          property :synthesize_speech_config, as: 'synthesizeSpeechConfig', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SynthesizeSpeechConfig, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SynthesizeSpeechConfig::Representation
+      
+        end
+      end
+      
       class GoogleCloudDialogflowV2QueryInput
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1202,6 +1254,8 @@ module Google
       
           hash :payload, as: 'payload'
           property :reset_contexts, as: 'resetContexts'
+          property :sentiment_analysis_request_config, as: 'sentimentAnalysisRequestConfig', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SentimentAnalysisRequestConfig, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SentimentAnalysisRequestConfig::Representation
+      
           collection :session_entity_types, as: 'sessionEntityTypes', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SessionEntityType, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SessionEntityType::Representation
       
           property :time_zone, as: 'timeZone'
@@ -1225,6 +1279,8 @@ module Google
       
           hash :parameters, as: 'parameters'
           property :query_text, as: 'queryText'
+          property :sentiment_analysis_result, as: 'sentimentAnalysisResult', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SentimentAnalysisResult, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SentimentAnalysisResult::Representation
+      
           property :speech_recognition_confidence, as: 'speechRecognitionConfidence'
           hash :webhook_payload, as: 'webhookPayload'
           property :webhook_source, as: 'webhookSource'
@@ -1248,6 +1304,29 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2Sentiment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :magnitude, as: 'magnitude'
+          property :score, as: 'score'
+        end
+      end
+      
+      class GoogleCloudDialogflowV2SentimentAnalysisRequestConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :analyze_query_text_sentiment, as: 'analyzeQueryTextSentiment'
+        end
+      end
+      
+      class GoogleCloudDialogflowV2SentimentAnalysisResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :query_text_sentiment, as: 'queryTextSentiment', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Sentiment, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Sentiment::Representation
+      
+        end
+      end
+      
       class GoogleCloudDialogflowV2SessionEntityType
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1258,6 +1337,18 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2SynthesizeSpeechConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :effects_profile_id, as: 'effectsProfileId'
+          property :pitch, as: 'pitch'
+          property :speaking_rate, as: 'speakingRate'
+          property :voice, as: 'voice', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2VoiceSelectionParams, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2VoiceSelectionParams::Representation
+      
+          property :volume_gain_db, as: 'volumeGainDb'
+        end
+      end
+      
       class GoogleCloudDialogflowV2TextInput
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1272,6 +1363,14 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2VoiceSelectionParams
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :ssml_gender, as: 'ssmlGender'
+        end
+      end
+      
       class GoogleCloudDialogflowV2WebhookRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/dialogflow_v2beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow-enterprise/
     module DialogflowV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20190318'
+      REVISION = '20190429'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -1332,6 +1332,12 @@ module Google
         # @return [String]
         attr_accessor :query_text
       
+        # The result of sentiment analysis as configured by
+        # `sentiment_analysis_request_config`.
+        # Corresponds to the JSON property `sentimentAnalysisResult`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2SentimentAnalysisResult]
+        attr_accessor :sentiment_analysis_result
+      
         # The Speech recognition confidence between 0.0 and 1.0. A higher number
         # indicates an estimated greater likelihood that the recognized words are
         # correct. The default of 0.0 is a sentinel value indicating that confidence
@@ -1373,12 +1379,62 @@ module Google
           @output_contexts = args[:output_contexts] if args.key?(:output_contexts)
           @parameters = args[:parameters] if args.key?(:parameters)
           @query_text = args[:query_text] if args.key?(:query_text)
+          @sentiment_analysis_result = args[:sentiment_analysis_result] if args.key?(:sentiment_analysis_result)
           @speech_recognition_confidence = args[:speech_recognition_confidence] if args.key?(:speech_recognition_confidence)
           @webhook_payload = args[:webhook_payload] if args.key?(:webhook_payload)
           @webhook_source = args[:webhook_source] if args.key?(:webhook_source)
         end
       end
       
+      # The sentiment, such as positive/negative feeling or association, for a unit
+      # of analysis, such as the query text.
+      class GoogleCloudDialogflowV2Sentiment
+        include Google::Apis::Core::Hashable
+      
+        # A non-negative number in the [0, +inf) range, which represents the absolute
+        # magnitude of sentiment, regardless of score (positive or negative).
+        # Corresponds to the JSON property `magnitude`
+        # @return [Float]
+        attr_accessor :magnitude
+      
+        # Sentiment score between -1.0 (negative sentiment) and 1.0 (positive
+        # sentiment).
+        # Corresponds to the JSON property `score`
+        # @return [Float]
+        attr_accessor :score
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @magnitude = args[:magnitude] if args.key?(:magnitude)
+          @score = args[:score] if args.key?(:score)
+        end
+      end
+      
+      # The result of sentiment analysis as configured by
+      # `sentiment_analysis_request_config`.
+      class GoogleCloudDialogflowV2SentimentAnalysisResult
+        include Google::Apis::Core::Hashable
+      
+        # The sentiment, such as positive/negative feeling or association, for a unit
+        # of analysis, such as the query text.
+        # Corresponds to the JSON property `queryTextSentiment`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2Sentiment]
+        attr_accessor :query_text_sentiment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @query_text_sentiment = args[:query_text_sentiment] if args.key?(:query_text_sentiment)
+        end
+      end
+      
       # The request message for a webhook call.
       class GoogleCloudDialogflowV2WebhookRequest
         include Google::Apis::Core::Hashable
@@ -2378,7 +2434,7 @@ module Google
         end
       end
       
-      # Instructs the speech recognizer how to process the audio content.
+      # Instructs the speech recognizer on how to process the audio content.
       class GoogleCloudDialogflowV2beta1InputAudioConfig
         include Google::Apis::Core::Hashable
       
@@ -2413,6 +2469,11 @@ module Google
         # @return [String]
         attr_accessor :model
       
+        # Optional. Which variant of the Speech model to use.
+        # Corresponds to the JSON property `modelVariant`
+        # @return [String]
+        attr_accessor :model_variant
+      
         # Optional. The collection of phrase hints which are used to boost accuracy
         # of speech recognition.
         # Refer to
@@ -2442,6 +2503,7 @@ module Google
           @audio_encoding = args[:audio_encoding] if args.key?(:audio_encoding)
           @language_code = args[:language_code] if args.key?(:language_code)
           @model = args[:model] if args.key?(:model)
+          @model_variant = args[:model_variant] if args.key?(:model_variant)
           @phrase_hints = args[:phrase_hints] if args.key?(:phrase_hints)
           @sample_rate_hertz = args[:sample_rate_hertz] if args.key?(:sample_rate_hertz)
         end
@@ -3906,7 +3968,7 @@ module Google
       class GoogleCloudDialogflowV2beta1QueryInput
         include Google::Apis::Core::Hashable
       
-        # Instructs the speech recognizer how to process the audio content.
+        # Instructs the speech recognizer on how to process the audio content.
         # Corresponds to the JSON property `audioConfig`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1InputAudioConfig]
         attr_accessor :audio_config

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

@@ -220,6 +220,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2Sentiment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowV2SentimentAnalysisResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2WebhookRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1072,12 +1084,30 @@ module Google
       
           hash :parameters, as: 'parameters'
           property :query_text, as: 'queryText'
+          property :sentiment_analysis_result, as: 'sentimentAnalysisResult', class: Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2SentimentAnalysisResult, decorator: Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2SentimentAnalysisResult::Representation
+      
           property :speech_recognition_confidence, as: 'speechRecognitionConfidence'
           hash :webhook_payload, as: 'webhookPayload'
           property :webhook_source, as: 'webhookSource'
         end
       end
       
+      class GoogleCloudDialogflowV2Sentiment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :magnitude, as: 'magnitude'
+          property :score, as: 'score'
+        end
+      end
+      
+      class GoogleCloudDialogflowV2SentimentAnalysisResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :query_text_sentiment, as: 'queryTextSentiment', class: Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2Sentiment, decorator: Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2Sentiment::Representation
+      
+        end
+      end
+      
       class GoogleCloudDialogflowV2WebhookRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1319,6 +1349,7 @@ module Google
           property :audio_encoding, as: 'audioEncoding'
           property :language_code, as: 'languageCode'
           property :model, as: 'model'
+          property :model_variant, as: 'modelVariant'
           collection :phrase_hints, as: 'phraseHints'
           property :sample_rate_hertz, as: 'sampleRateHertz'
         end

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 = '20190326'
+      REVISION = '20190422'
 
       # 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

@@ -1287,6 +1287,15 @@ module Google
         end
       end
       
+      # Replaces an identifier with a surrogate using Format Preserving Encryption
+      # (FPE) with the FFX mode of operation; however when used in the
+      # `ReidentifyContent` API method, it serves the opposite function by reversing
+      # the surrogate back into the original identifier. The identifier must be
+      # encoded as ASCII. For a given crypto key and context, the same identifier
+      # will be replaced with the same surrogate. Identifiers must be at least two
+      # characters long. In the case that the identifier is the empty string, it will
+      # be skipped. See https://cloud.google.com/dlp/docs/pseudonymization to learn
+      # more.
       # Note: We recommend using  CryptoDeterministicConfig for all use cases which
       # do not require preserving the input alphabet space and size, plus warrant
       # referential integrity.
@@ -2937,8 +2946,7 @@ module Google
       class GooglePrivacyDlpV2InspectJobConfig
         include Google::Apis::Core::Hashable
       
-        # Actions to execute at the completion of the job. Are executed in the order
-        # provided.
+        # Actions to execute at the completion of the job.
         # Corresponds to the JSON property `actions`
         # @return [Array<Google::Apis::DlpV2::GooglePrivacyDlpV2Action>]
         attr_accessor :actions
@@ -4162,6 +4170,15 @@ module Google
         # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoHashConfig]
         attr_accessor :crypto_hash_config
       
+        # Replaces an identifier with a surrogate using Format Preserving Encryption
+        # (FPE) with the FFX mode of operation; however when used in the
+        # `ReidentifyContent` API method, it serves the opposite function by reversing
+        # the surrogate back into the original identifier. The identifier must be
+        # encoded as ASCII. For a given crypto key and context, the same identifier
+        # will be replaced with the same surrogate. Identifiers must be at least two
+        # characters long. In the case that the identifier is the empty string, it will
+        # be skipped. See https://cloud.google.com/dlp/docs/pseudonymization to learn
+        # more.
         # Note: We recommend using  CryptoDeterministicConfig for all use cases which
         # do not require preserving the input alphabet space and size, plus warrant
         # referential integrity.

data/generated/google/apis/dns_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/cloud-dns
     module DnsV1
       VERSION = 'V1'
-      REVISION = '20190312'
+      REVISION = '20190418'
 
       # 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_v1/classes.rb

@@ -22,26 +22,32 @@ module Google
   module Apis
     module DnsV1
       
-      # 
+      # 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::DnsV1::ResourceRecordSet>]
         attr_accessor :additions
       
-        # 
+        # Which ResourceRecordSets to remove? Must match existing data exactly.
         # Corresponds to the JSON property `deletions`
         # @return [Array<Google::Apis::DnsV1::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
@@ -52,12 +58,15 @@ module Google
         # @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 ListChangesResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # The requested changes.
         # Corresponds to the JSON property `changes`
         # @return [Array<Google::Apis::DnsV1::Change>]
         attr_accessor :changes
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -97,7 +107,14 @@ 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,47 +132,59 @@ 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::DnsV1::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
@@ -165,12 +194,16 @@ module Google
         # @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 +232,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,21 +254,26 @@ 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
@@ -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::DnsV1::DnsKey>]
         attr_accessor :dns_keys
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -277,7 +316,14 @@ 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,31 +341,35 @@ 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::DnsV1::ManagedZoneDnsSecConfig]
         attr_accessor :dnssec_config
       
-        # 
+        # Unique identifier for the resource; defined by the server (output only)
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
@@ -330,32 +380,39 @@ module Google
         # @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
       
-        # 
+        # 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::DnsV1::ManagedZonePrivateVisibilityConfig]
         attr_accessor :private_visibility_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
@@ -385,7 +442,8 @@ module Google
       class ManagedZoneDnsSecConfig
         include Google::Apis::Core::Hashable
       
-        # 
+        # Specifies parameters that will be used for generating initial DnsKeys for this
+        # ManagedZone. Output only while state is not OFF.
         # Corresponds to the JSON property `defaultKeySpecs`
         # @return [Array<Google::Apis::DnsV1::DnsKeySpec>]
         attr_accessor :default_key_specs
@@ -396,12 +454,13 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # Specifies the mechanism used to provide authenticated denial-of-existence
+        # responses. Output only while state is not 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
@@ -423,7 +482,7 @@ module Google
       class ManagedZoneOperationsListResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -433,12 +492,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 operation resources.
         # Corresponds to the JSON property `operations`
         # @return [Array<Google::Apis::DnsV1::Operation>]
         attr_accessor :operations
@@ -466,7 +533,7 @@ module Google
         # @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::DnsV1::ManagedZonePrivateVisibilityConfigNetwork>]
         attr_accessor :networks
@@ -492,7 +559,9 @@ module Google
         # @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
@@ -512,7 +581,7 @@ module Google
       class ListManagedZonesResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -522,12 +591,20 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # 
+        # The managed zone resources.
         # Corresponds to the JSON property `managedZones`
         # @return [Array<Google::Apis::DnsV1::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
@@ -545,16 +622,22 @@ 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::DnsV1::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
@@ -565,27 +648,32 @@ module Google
         # @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::DnsV1::OperationManagedZoneContext]
         attr_accessor :zone_context
@@ -611,12 +699,12 @@ module Google
       class OperationDnsKeyContext
         include Google::Apis::Core::Hashable
       
-        # 
+        # A DNSSEC key pair.
         # Corresponds to the JSON property `newValue`
         # @return [Google::Apis::DnsV1::DnsKey]
         attr_accessor :new_value
       
-        # 
+        # A DNSSEC key pair.
         # Corresponds to the JSON property `oldValue`
         # @return [Google::Apis::DnsV1::DnsKey]
         attr_accessor :old_value
@@ -636,12 +724,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::DnsV1::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::DnsV1::ManagedZone]
         attr_accessor :old_value
@@ -657,11 +749,13 @@ 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
@@ -672,12 +766,13 @@ module Google
         # @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::DnsV1::Quota]
         attr_accessor :quota
@@ -695,11 +790,11 @@ 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
@@ -709,47 +804,49 @@ module Google
         # @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 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 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::DnsV1::DnsKeySpec>]
         attr_accessor :whitelisted_key_specs
@@ -774,7 +871,7 @@ module Google
         end
       end
       
-      # 
+      # A unit of data that will be returned by the DNS servers.
       class ResourceRecordSet
         include Google::Apis::Core::Hashable
       
@@ -784,27 +881,29 @@ module Google
         # @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
+        # examples.
         # 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 Supported DNS
+        # record types.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -828,7 +927,7 @@ module Google
       class ListResourceRecordSetsResponse
         include Google::Apis::Core::Hashable
       
-        # 
+        # Elements common to every response.
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -838,12 +937,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::DnsV1::ResourceRecordSet>]
         attr_accessor :rrsets
@@ -861,11 +968,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