google-api-client 0.20.1 → 0.21.0

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

@@ -52,6 +52,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AddDimensionGroupRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AddDimensionGroupResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AddFilterViewRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -418,6 +430,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DateTimeRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DeleteBandingRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -448,6 +466,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DeleteDimensionGroupRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class DeleteDimensionGroupResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DeleteDimensionRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -508,6 +538,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DimensionGroup
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DimensionProperties
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1000,6 +1036,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UpdateDimensionGroupRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class UpdateDimensionPropertiesRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1137,6 +1179,22 @@ module Google
         end
       end
       
+      class AddDimensionGroupRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :range, as: 'range', class: Google::Apis::SheetsV4::DimensionRange, decorator: Google::Apis::SheetsV4::DimensionRange::Representation
+      
+        end
+      end
+      
+      class AddDimensionGroupResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :dimension_groups, as: 'dimensionGroups', class: Google::Apis::SheetsV4::DimensionGroup, decorator: Google::Apis::SheetsV4::DimensionGroup::Representation
+      
+        end
+      end
+      
       class AddFilterViewRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1300,6 +1358,8 @@ module Google
       class BasicChartSeries
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :color, as: 'color', class: Google::Apis::SheetsV4::Color, decorator: Google::Apis::SheetsV4::Color::Representation
+      
           property :line_style, as: 'lineStyle', class: Google::Apis::SheetsV4::LineStyle, decorator: Google::Apis::SheetsV4::LineStyle::Representation
       
           property :series, as: 'series', class: Google::Apis::SheetsV4::ChartData, decorator: Google::Apis::SheetsV4::ChartData::Representation
@@ -1814,6 +1874,13 @@ module Google
         end
       end
       
+      class DateTimeRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :type, as: 'type'
+        end
+      end
+      
       class DeleteBandingRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1853,6 +1920,22 @@ module Google
         end
       end
       
+      class DeleteDimensionGroupRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :range, as: 'range', class: Google::Apis::SheetsV4::DimensionRange, decorator: Google::Apis::SheetsV4::DimensionRange::Representation
+      
+        end
+      end
+      
+      class DeleteDimensionGroupResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :dimension_groups, as: 'dimensionGroups', class: Google::Apis::SheetsV4::DimensionGroup, decorator: Google::Apis::SheetsV4::DimensionGroup::Representation
+      
+        end
+      end
+      
       class DeleteDimensionRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1942,6 +2025,16 @@ module Google
         end
       end
       
+      class DimensionGroup
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :collapsed, as: 'collapsed'
+          property :depth, as: 'depth'
+          property :range, as: 'range', class: Google::Apis::SheetsV4::DimensionRange, decorator: Google::Apis::SheetsV4::DimensionRange::Representation
+      
+        end
+      end
+      
       class DimensionProperties
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2145,10 +2238,12 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :column_count, as: 'columnCount'
+          property :column_group_control_after, as: 'columnGroupControlAfter'
           property :frozen_column_count, as: 'frozenColumnCount'
           property :frozen_row_count, as: 'frozenRowCount'
           property :hide_gridlines, as: 'hideGridlines'
           property :row_count, as: 'rowCount'
+          property :row_group_control_after, as: 'rowGroupControlAfter'
         end
       end
       
@@ -2403,6 +2498,8 @@ module Google
       class PivotGroupRule
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :date_time_rule, as: 'dateTimeRule', class: Google::Apis::SheetsV4::DateTimeRule, decorator: Google::Apis::SheetsV4::DateTimeRule::Representation
+      
           property :histogram_rule, as: 'histogramRule', class: Google::Apis::SheetsV4::HistogramRule, decorator: Google::Apis::SheetsV4::HistogramRule::Representation
       
           property :manual_rule, as: 'manualRule', class: Google::Apis::SheetsV4::ManualRule, decorator: Google::Apis::SheetsV4::ManualRule::Representation
@@ -2501,6 +2598,8 @@ module Google
       
           property :add_conditional_format_rule, as: 'addConditionalFormatRule', class: Google::Apis::SheetsV4::AddConditionalFormatRuleRequest, decorator: Google::Apis::SheetsV4::AddConditionalFormatRuleRequest::Representation
       
+          property :add_dimension_group, as: 'addDimensionGroup', class: Google::Apis::SheetsV4::AddDimensionGroupRequest, decorator: Google::Apis::SheetsV4::AddDimensionGroupRequest::Representation
+      
           property :add_filter_view, as: 'addFilterView', class: Google::Apis::SheetsV4::AddFilterViewRequest, decorator: Google::Apis::SheetsV4::AddFilterViewRequest::Representation
       
           property :add_named_range, as: 'addNamedRange', class: Google::Apis::SheetsV4::AddNamedRangeRequest, decorator: Google::Apis::SheetsV4::AddNamedRangeRequest::Representation
@@ -2533,6 +2632,8 @@ module Google
       
           property :delete_dimension, as: 'deleteDimension', class: Google::Apis::SheetsV4::DeleteDimensionRequest, decorator: Google::Apis::SheetsV4::DeleteDimensionRequest::Representation
       
+          property :delete_dimension_group, as: 'deleteDimensionGroup', class: Google::Apis::SheetsV4::DeleteDimensionGroupRequest, decorator: Google::Apis::SheetsV4::DeleteDimensionGroupRequest::Representation
+      
           property :delete_embedded_object, as: 'deleteEmbeddedObject', class: Google::Apis::SheetsV4::DeleteEmbeddedObjectRequest, decorator: Google::Apis::SheetsV4::DeleteEmbeddedObjectRequest::Representation
       
           property :delete_filter_view, as: 'deleteFilterView', class: Google::Apis::SheetsV4::DeleteFilterViewRequest, decorator: Google::Apis::SheetsV4::DeleteFilterViewRequest::Representation
@@ -2587,6 +2688,8 @@ module Google
       
           property :update_developer_metadata, as: 'updateDeveloperMetadata', class: Google::Apis::SheetsV4::UpdateDeveloperMetadataRequest, decorator: Google::Apis::SheetsV4::UpdateDeveloperMetadataRequest::Representation
       
+          property :update_dimension_group, as: 'updateDimensionGroup', class: Google::Apis::SheetsV4::UpdateDimensionGroupRequest, decorator: Google::Apis::SheetsV4::UpdateDimensionGroupRequest::Representation
+      
           property :update_dimension_properties, as: 'updateDimensionProperties', class: Google::Apis::SheetsV4::UpdateDimensionPropertiesRequest, decorator: Google::Apis::SheetsV4::UpdateDimensionPropertiesRequest::Representation
       
           property :update_embedded_object_position, as: 'updateEmbeddedObjectPosition', class: Google::Apis::SheetsV4::UpdateEmbeddedObjectPositionRequest, decorator: Google::Apis::SheetsV4::UpdateEmbeddedObjectPositionRequest::Representation
@@ -2611,6 +2714,8 @@ module Google
       
           property :add_chart, as: 'addChart', class: Google::Apis::SheetsV4::AddChartResponse, decorator: Google::Apis::SheetsV4::AddChartResponse::Representation
       
+          property :add_dimension_group, as: 'addDimensionGroup', class: Google::Apis::SheetsV4::AddDimensionGroupResponse, decorator: Google::Apis::SheetsV4::AddDimensionGroupResponse::Representation
+      
           property :add_filter_view, as: 'addFilterView', class: Google::Apis::SheetsV4::AddFilterViewResponse, decorator: Google::Apis::SheetsV4::AddFilterViewResponse::Representation
       
           property :add_named_range, as: 'addNamedRange', class: Google::Apis::SheetsV4::AddNamedRangeResponse, decorator: Google::Apis::SheetsV4::AddNamedRangeResponse::Representation
@@ -2625,6 +2730,8 @@ module Google
       
           property :delete_developer_metadata, as: 'deleteDeveloperMetadata', class: Google::Apis::SheetsV4::DeleteDeveloperMetadataResponse, decorator: Google::Apis::SheetsV4::DeleteDeveloperMetadataResponse::Representation
       
+          property :delete_dimension_group, as: 'deleteDimensionGroup', class: Google::Apis::SheetsV4::DeleteDimensionGroupResponse, decorator: Google::Apis::SheetsV4::DeleteDimensionGroupResponse::Representation
+      
           property :duplicate_filter_view, as: 'duplicateFilterView', class: Google::Apis::SheetsV4::DuplicateFilterViewResponse, decorator: Google::Apis::SheetsV4::DuplicateFilterViewResponse::Representation
       
           property :duplicate_sheet, as: 'duplicateSheet', class: Google::Apis::SheetsV4::DuplicateSheetResponse, decorator: Google::Apis::SheetsV4::DuplicateSheetResponse::Representation
@@ -2691,6 +2798,8 @@ module Google
       
           collection :charts, as: 'charts', class: Google::Apis::SheetsV4::EmbeddedChart, decorator: Google::Apis::SheetsV4::EmbeddedChart::Representation
       
+          collection :column_groups, as: 'columnGroups', class: Google::Apis::SheetsV4::DimensionGroup, decorator: Google::Apis::SheetsV4::DimensionGroup::Representation
+      
           collection :conditional_formats, as: 'conditionalFormats', class: Google::Apis::SheetsV4::ConditionalFormatRule, decorator: Google::Apis::SheetsV4::ConditionalFormatRule::Representation
       
           collection :data, as: 'data', class: Google::Apis::SheetsV4::GridData, decorator: Google::Apis::SheetsV4::GridData::Representation
@@ -2705,6 +2814,8 @@ module Google
       
           collection :protected_ranges, as: 'protectedRanges', class: Google::Apis::SheetsV4::ProtectedRange, decorator: Google::Apis::SheetsV4::ProtectedRange::Representation
       
+          collection :row_groups, as: 'rowGroups', class: Google::Apis::SheetsV4::DimensionGroup, decorator: Google::Apis::SheetsV4::DimensionGroup::Representation
+      
         end
       end
       
@@ -2970,6 +3081,15 @@ module Google
         end
       end
       
+      class UpdateDimensionGroupRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :dimension_group, as: 'dimensionGroup', class: Google::Apis::SheetsV4::DimensionGroup, decorator: Google::Apis::SheetsV4::DimensionGroup::Representation
+      
+          property :fields, as: 'fields'
+        end
+      end
+      
       class UpdateDimensionPropertiesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -38,14 +38,12 @@ module Google
         attr_accessor :key
 
         # @return [String]
-        #  Available to use for quota purposes for server-side applications. Can be any
-        #  arbitrary string assigned to a user, but should not exceed 40 characters.
-        #  Overrides userIp if both are provided.
+        #  An opaque string that represents a user for quota purposes. Must not exceed 40
+        #  characters.
         attr_accessor :quota_user
 
         # @return [String]
-        #  IP address of the site where the request originates. Use this if you want to
-        #  enforce per-user limits.
+        #  Deprecated. Please use quotaUser instead.
         attr_accessor :user_ip
 
         def initialize
@@ -59,12 +57,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -92,12 +88,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -126,12 +120,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -163,12 +155,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -198,12 +188,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -234,12 +222,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -272,12 +258,10 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #

data/generated/google/apis/slides_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/slides/
     module SlidesV1
       VERSION = 'V1'
-      REVISION = '20180329'
+      REVISION = '20180409'
 
       # View and manage the files in your Google Drive
       AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'

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

@@ -1538,7 +1538,7 @@ module Google
       end
       
       # A PageElement kind representing a
-      # non-connector line, straight connector, curved connector or bent connector.
+      # non-connector line, straight connector, curved connector, or bent connector.
       class Line
         include Google::Apis::Core::Hashable
       
@@ -2082,7 +2082,7 @@ module Google
         attr_accessor :image
       
         # A PageElement kind representing a
-        # non-connector line, straight connector, curved connector or bent connector.
+        # non-connector line, straight connector, curved connector, or bent connector.
         # Corresponds to the JSON property `line`
         # @return [Google::Apis::SlidesV1::Line]
         attr_accessor :line
@@ -2568,6 +2568,8 @@ module Google
       end
       
       # Replaces all shapes that match the given criteria with the provided image.
+      # The images replacing the shapes are rectangular after being inserted into
+      # the presentation and do not take on the forms of the shapes.
       class ReplaceAllShapesWithImageRequest
         include Google::Apis::Core::Hashable
       
@@ -2938,6 +2940,8 @@ module Google
         attr_accessor :refresh_sheets_chart
       
         # Replaces all shapes that match the given criteria with the provided image.
+        # The images replacing the shapes are rectangular after being inserted into
+        # the presentation and do not take on the forms of the shapes.
         # Corresponds to the JSON property `replaceAllShapesWithImage`
         # @return [Google::Apis::SlidesV1::ReplaceAllShapesWithImageRequest]
         attr_accessor :replace_all_shapes_with_image

data/generated/google/apis/spanner_v1.rb

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

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

@@ -194,6 +194,7 @@ module Google
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `options`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :options
@@ -469,6 +470,7 @@ module Google
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `singleUseTransaction`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :single_use_transaction
@@ -737,21 +739,21 @@ module Google
         # from a JSON value.  For example, values of type `BYTES` and values
         # of type `STRING` both appear in params as JSON strings.
         # In these cases, `param_types` can be used to specify the exact
-        # SQL type for some or all of the SQL query parameters. See the
+        # SQL type for some or all of the SQL statement parameters. See the
         # definition of Type for more information
         # about SQL types.
         # Corresponds to the JSON property `paramTypes`
         # @return [Hash<String,Google::Apis::SpannerV1::Type>]
         attr_accessor :param_types
       
-        # The SQL query string can contain parameter placeholders. A parameter
+        # The SQL string can contain parameter placeholders. A parameter
         # placeholder consists of `'@'` followed by the parameter
         # name. Parameter names consist of any combination of letters,
         # numbers, and underscores.
         # Parameters can appear anywhere that a literal value is expected.  The same
         # parameter name can be used more than once, for example:
         # `"WHERE id > @msg_id AND id < @msg_id + 100"`
-        # It is an error to execute an SQL query with unbound parameters.
+        # It is an error to execute an SQL statement with unbound parameters.
         # Parameter values are specified using `params`, which is a JSON
         # object whose keys are parameter names, and whose values are the
         # corresponding parameter values.
@@ -775,10 +777,10 @@ module Google
         # @return [String]
         attr_accessor :query_mode
       
-        # If this request is resuming a previously interrupted SQL query
+        # If this request is resuming a previously interrupted SQL statement
         # execution, `resume_token` should be copied from the last
         # PartialResultSet yielded before the interruption. Doing this
-        # enables the new SQL query execution to resume where the last one left
+        # enables the new SQL statement execution to resume where the last one left
         # off. The rest of the request parameters must exactly match the
         # request that yielded this token.
         # Corresponds to the JSON property `resumeToken`
@@ -786,7 +788,7 @@ module Google
         # @return [String]
         attr_accessor :resume_token
       
-        # Required. The SQL query string.
+        # Required. The SQL string.
         # Corresponds to the JSON property `sql`
         # @return [String]
         attr_accessor :sql
@@ -1806,11 +1808,11 @@ module Google
       
       # Defines an Identity and Access Management (IAM) policy. It is used to
       # specify access control policies for Cloud Platform resources.
-      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
       # `members` to a `role`, where the members can be user accounts, Google groups,
       # Google domains, and service accounts. A `role` is a named list of permissions
       # defined by IAM.
-      # **Example**
+      # **JSON Example**
       # `
       # "bindings": [
       # `
@@ -1819,7 +1821,7 @@ module Google
       # "user:mike@example.com",
       # "group:admins@example.com",
       # "domain:google.com",
-      # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
       # ]
       # `,
       # `
@@ -1828,6 +1830,17 @@ module Google
       # `
       # ]
       # `
+      # **YAML Example**
+      # bindings:
+      # - members:
+      # - user:mike@example.com
+      # - group:admins@example.com
+      # - domain:google.com
+      # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+      # role: roles/owner
+      # - members:
+      # - user:sean@example.com
+      # role: roles/viewer
       # For a description of IAM and its features, see the
       # [IAM developer's guide](https://cloud.google.com/iam/docs).
       class Policy
@@ -2241,11 +2254,11 @@ module Google
       
         # Defines an Identity and Access Management (IAM) policy. It is used to
         # specify access control policies for Cloud Platform resources.
-        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
         # `members` to a `role`, where the members can be user accounts, Google groups,
         # Google domains, and service accounts. A `role` is a named list of permissions
         # defined by IAM.
-        # **Example**
+        # **JSON Example**
         # `
         # "bindings": [
         # `
@@ -2254,7 +2267,7 @@ module Google
         # "user:mike@example.com",
         # "group:admins@example.com",
         # "domain:google.com",
-        # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
         # ]
         # `,
         # `
@@ -2263,6 +2276,17 @@ module Google
         # `
         # ]
         # `
+        # **YAML Example**
+        # bindings:
+        # - members:
+        # - user:mike@example.com
+        # - group:admins@example.com
+        # - domain:google.com
+        # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+        # role: roles/owner
+        # - members:
+        # - user:sean@example.com
+        # role: roles/viewer
         # For a description of IAM and its features, see the
         # [IAM developer's guide](https://cloud.google.com/iam/docs).
         # Corresponds to the JSON property `policy`
@@ -2650,6 +2674,7 @@ module Google
       # restriction also applies to in-progress reads and/or SQL queries whose
       # timestamp become too old while executing. Reads and SQL queries with
       # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+      # ##
       class TransactionOptions
         include Google::Apis::Core::Hashable
       
@@ -2850,6 +2875,7 @@ module Google
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `begin`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :begin
@@ -3028,6 +3054,7 @@ module Google
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `singleUse`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :single_use