google-analytics-admin-v1alpha 0.28.1 → 0.30.0

data/proto_docs/google/analytics/admin/v1alpha/analytics_admin.rb

@@ -353,7 +353,8 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. Format: properties/\\{property_id}
-        #     Example: properties/1234
+        #
+        #     Example: `properties/1234`
         # @!attribute [rw] firebase_link
         #   @return [::Google::Analytics::Admin::V1alpha::FirebaseLink]
         #     Required. The Firebase link to create.
@@ -366,7 +367,8 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Format: properties/\\{property_id}/firebaseLinks/\\{firebase_link_id}
-        #     Example: properties/1234/firebaseLinks/5678
+        #
+        #     Example: `properties/1234/firebaseLinks/5678`
         class DeleteFirebaseLinkRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -376,7 +378,8 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. Format: properties/\\{property_id}
-        #     Example: properties/1234
+        #
+        #     Example: `properties/1234`
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     The maximum number of resources to return. The service may return
@@ -415,7 +418,8 @@ module Google
         #     Required. The name of the site tag to lookup.
         #     Note that site tags are singletons and do not have unique IDs.
         #     Format: properties/\\{property_id}/dataStreams/\\{stream_id}/globalSiteTag
-        #     Example: "properties/123/dataStreams/456/globalSiteTag"
+        #
+        #     Example: `properties/123/dataStreams/456/globalSiteTag`
         class GetGlobalSiteTagRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -496,7 +500,8 @@ module Google
         #   @return [::String]
         #     Required. The name of the settings to lookup.
         #     Format: accounts/\\{account}/dataSharingSettings
-        #     Example: "accounts/1000/dataSharingSettings"
+        #
+        #     Example: `accounts/1000/dataSharingSettings`
         class GetDataSharingSettingsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -562,13 +567,16 @@ module Google
         # @!attribute [rw] account
         #   @return [::String]
         #     Required. The account resource for which to return change history
-        #     resources. Format: accounts/\\{account} Example: "accounts/100"
+        #     resources. Format: accounts/\\{account}
+        #
+        #     Example: `accounts/100`
         # @!attribute [rw] property
         #   @return [::String]
         #     Optional. Resource name for a child property. If set, only return changes
         #     made to this property or its child resources.
         #     Format: properties/\\{propertyId}
-        #     Example: "properties/100"
+        #
+        #     Example: `properties/100`
         # @!attribute [rw] resource_type
         #   @return [::Array<::Google::Analytics::Admin::V1alpha::ChangeHistoryResourceType>]
         #     Optional. If set, only return changes if they are for a resource that
@@ -902,6 +910,91 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for CreateKeyEvent RPC
+        # @!attribute [rw] key_event
+        #   @return [::Google::Analytics::Admin::V1alpha::KeyEvent]
+        #     Required. The Key Event to create.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the parent property where this Key Event
+        #     will be created. Format: properties/123
+        class CreateKeyEventRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for UpdateKeyEvent RPC
+        # @!attribute [rw] key_event
+        #   @return [::Google::Analytics::Admin::V1alpha::KeyEvent]
+        #     Required. The Key Event to update.
+        #     The `name` field is used to identify the settings to be updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The list of fields to be updated. Field names must be in snake
+        #     case (e.g., "field_to_update"). Omitted fields will not be updated. To
+        #     replace the entire entity, use one path with the string "*" to match all
+        #     fields.
+        class UpdateKeyEventRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for GetKeyEvent RPC
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Key Event to retrieve.
+        #     Format: properties/\\{property}/keyEvents/\\{key_event}
+        #     Example: "properties/123/keyEvents/456"
+        class GetKeyEventRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for DeleteKeyEvent RPC
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Key Event to delete.
+        #     Format: properties/\\{property}/keyEvents/\\{key_event}
+        #     Example: "properties/123/keyEvents/456"
+        class DeleteKeyEventRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListKeyEvents RPC
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the parent property.
+        #     Example: 'properties/123'
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of resources to return.
+        #     If unspecified, at most 50 resources will be returned.
+        #     The maximum value is 200; (higher values will be coerced to the maximum)
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token, received from a previous `ListKeyEvents` call.
+        #     Provide this to retrieve the subsequent page.
+        #     When paginating, all other parameters provided to `ListKeyEvents`
+        #     must match the call that provided the page token.
+        class ListKeyEventsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListKeyEvents RPC.
+        # @!attribute [rw] key_events
+        #   @return [::Array<::Google::Analytics::Admin::V1alpha::KeyEvent>]
+        #     The requested Key Events
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        class ListKeyEventsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for GetDisplayVideo360AdvertiserLink RPC.
         # @!attribute [rw] name
         #   @return [::String]
@@ -2025,6 +2118,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for CreateBigQueryLink RPC.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Example format: properties/1234
+        # @!attribute [rw] bigquery_link
+        #   @return [::Google::Analytics::Admin::V1alpha::BigQueryLink]
+        #     Required. The BigQueryLink to create.
+        class CreateBigQueryLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for GetBigQueryLink RPC.
         # @!attribute [rw] name
         #   @return [::String]
@@ -2072,6 +2177,32 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for UpdateBigQueryLink RPC.
+        # @!attribute [rw] bigquery_link
+        #   @return [::Google::Analytics::Admin::V1alpha::BigQueryLink]
+        #     Required. The settings to update.
+        #     The `name` field is used to identify the settings to be updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The list of fields to be updated. Field names must be in snake
+        #     case (e.g., "field_to_update"). Omitted fields will not be updated. To
+        #     replace the entire entity, use one path with the string "*" to match all
+        #     fields.
+        class UpdateBigQueryLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for DeleteBigQueryLink RPC.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The BigQueryLink to delete.
+        #     Example format: properties/1234/bigQueryLinks/5678
+        class DeleteBigQueryLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for GetEnhancedMeasurementSettings RPC.
         # @!attribute [rw] name
         #   @return [::String]
@@ -2368,6 +2499,103 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for CreateEventEditRule RPC.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Example format: properties/123/dataStreams/456
+        # @!attribute [rw] event_edit_rule
+        #   @return [::Google::Analytics::Admin::V1alpha::EventEditRule]
+        #     Required. The EventEditRule to create.
+        class CreateEventEditRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for UpdateEventEditRule RPC.
+        # @!attribute [rw] event_edit_rule
+        #   @return [::Google::Analytics::Admin::V1alpha::EventEditRule]
+        #     Required. The EventEditRule to update.
+        #     The resource's `name` field is used to identify the EventEditRule to be
+        #     updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The list of fields to be updated. Field names must be in snake
+        #     case (e.g., "field_to_update"). Omitted fields will not be updated. To
+        #     replace the entire entity, use one path with the string "*" to match all
+        #     fields.
+        class UpdateEventEditRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for DeleteEventEditRule RPC.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Example format: properties/123/dataStreams/456/eventEditRules/789
+        class DeleteEventEditRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for GetEventEditRule RPC.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the EventEditRule to get.
+        #     Example format: properties/123/dataStreams/456/eventEditRules/789
+        class GetEventEditRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListEventEditRules RPC.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Example format: properties/123/dataStreams/456
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of resources to return.
+        #     If unspecified, at most 50 resources will be returned.
+        #     The maximum value is 200 (higher values will be coerced to the maximum).
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListEventEditRules` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListEventEditRules`
+        #     must match the call that provided the page token.
+        class ListEventEditRulesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListEventEditRules RPC.
+        # @!attribute [rw] event_edit_rules
+        #   @return [::Array<::Google::Analytics::Admin::V1alpha::EventEditRule>]
+        #     List of EventEditRules. These will be ordered stably, but in an arbitrary
+        #     order.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        class ListEventEditRulesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ReorderEventEditRules RPC.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Example format: properties/123/dataStreams/456
+        # @!attribute [rw] event_edit_rules
+        #   @return [::Array<::String>]
+        #     Required. EventEditRule resource names for the specified data stream, in
+        #     the needed processing order. All EventEditRules for the stream must be
+        #     present in the list.
+        class ReorderEventEditRulesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for CreateRollupProperty RPC.
         # @!attribute [rw] rollup_property
         #   @return [::Google::Analytics::Admin::V1alpha::Property]
@@ -2466,30 +2694,25 @@ module Google
         end
 
         # Request message for CreateSubproperty RPC.
-        # @!attribute [rw] parent
-        #   @return [::String]
-        #     Required. The ordinary property for which to create a subproperty.
-        #     Format: properties/property_id
-        #     Example: properties/123
         # @!attribute [rw] subproperty
         #   @return [::Google::Analytics::Admin::V1alpha::Property]
         #     Required. The subproperty to create.
         # @!attribute [rw] subproperty_event_filter
         #   @return [::Google::Analytics::Admin::V1alpha::SubpropertyEventFilter]
         #     Optional. The subproperty event filter to create on an ordinary property.
-        class CreateSubpropertyRequest
+        class ProvisionSubpropertyRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Response message for CreateSubproperty RPC.
+        # Response message for ProvisionSubproperty RPC.
         # @!attribute [rw] subproperty
         #   @return [::Google::Analytics::Admin::V1alpha::Property]
         #     The created subproperty.
         # @!attribute [rw] subproperty_event_filter
         #   @return [::Google::Analytics::Admin::V1alpha::SubpropertyEventFilter]
         #     The created subproperty event filter.
-        class CreateSubpropertyResponse
+        class ProvisionSubpropertyResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end

data/proto_docs/google/analytics/admin/v1alpha/audience.rb

@@ -376,6 +376,9 @@ module Google
         #   @return [::Array<::Google::Analytics::Admin::V1alpha::AudienceFilterClause>]
         #     Required. Immutable. Unordered list. Filter clauses that define the
         #     Audience. All clauses will be AND’ed together.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Time when the Audience was created.
         class Audience
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/analytics/admin/v1alpha/channel_group.rb

@@ -149,6 +149,14 @@ module Google
         #     Output only. If true, then this channel group is the Default Channel Group
         #     predefined by Google Analytics. Display name and grouping rules cannot be
         #     updated for this channel group.
+        # @!attribute [rw] primary
+        #   @return [::Boolean]
+        #     Optional. If true, this channel group will be used as the default channel
+        #     group for reports. Only one channel group can be set as `primary` at any
+        #     time. If the `primary` field gets set on a channel group, it will get unset
+        #     on the previous primary channel group.
+        #
+        #     The Google Analytics predefined channel group is the primary by default.
         class ChannelGroup
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/analytics/admin/v1alpha/event_create_and_edit.rb

@@ -86,6 +86,45 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # An Event Edit Rule defines conditions that will trigger the creation of an
+        # entirely new event based upon matched criteria of a source event. Additional
+        # mutations of the parameters from the source event can be defined.
+        #
+        # Unlike Event Create rules, Event Edit Rules are applied in their defined
+        # order.
+        #
+        # Event Edit rules can't be used to modify an event created from an Event
+        # Create rule.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Resource name for this EventEditRule resource.
+        #     Format:
+        #     properties/\\{property}/dataStreams/\\{data_stream}/eventEditRules/\\{event_edit_rule}
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. The display name of this event edit rule. Maximum of 255
+        #     characters.
+        # @!attribute [rw] event_conditions
+        #   @return [::Array<::Google::Analytics::Admin::V1alpha::MatchingCondition>]
+        #     Required. Conditions on the source event must match for this rule to be
+        #     applied. Must have at least one condition, and can have up to 10 max.
+        # @!attribute [rw] parameter_mutations
+        #   @return [::Array<::Google::Analytics::Admin::V1alpha::ParameterMutation>]
+        #     Required. Parameter mutations define parameter behavior on the new event,
+        #     and are applied in order. A maximum of 20 mutations can be applied.
+        # @!attribute [r] processing_order
+        #   @return [::Integer]
+        #     Output only. The order for which this rule will be processed. Rules with an
+        #     order value lower than this will be processed before this rule, rules with
+        #     an order value higher than this will be processed after this rule. New
+        #     event edit rules will be assigned an order value at the end of the order.
+        #
+        #     This value does not apply to event create rules.
+        class EventEditRule
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Defines a condition for when an Event Edit or Event Creation rule applies to
         # an event.
         # @!attribute [rw] field

data/proto_docs/google/analytics/admin/v1alpha/resources.rb

@@ -43,6 +43,11 @@ module Google
         #   @return [::Boolean]
         #     Output only. Indicates whether this Account is soft-deleted or not. Deleted
         #     accounts are excluded from List results unless specifically requested.
+        # @!attribute [r] gmp_organization
+        #   @return [::String]
+        #     Output only. The URI for a Google Marketing Platform organization resource.
+        #     Only set when this account is connected to a GMP organization.
+        #     Format: marketingplatformadmin.googleapis.com/organizations/\\{org_id}
         class Account
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -865,6 +870,73 @@ module Google
           end
         end
 
+        # A key event in a Google Analytics property.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Resource name of this key event.
+        #     Format: properties/\\{property}/keyEvents/\\{key_event}
+        # @!attribute [rw] event_name
+        #   @return [::String]
+        #     Immutable. The event name for this key event.
+        #     Examples: 'click', 'purchase'
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Time when this key event was created in the property.
+        # @!attribute [r] deletable
+        #   @return [::Boolean]
+        #     Output only. If set to true, this event can be deleted.
+        # @!attribute [r] custom
+        #   @return [::Boolean]
+        #     Output only. If set to true, this key event refers to a custom event.  If
+        #     set to false, this key event refers to a default event in GA. Default
+        #     events typically have special meaning in GA. Default events are usually
+        #     created for you by the GA system, but in some cases can be created by
+        #     property admins. Custom events count towards the maximum number of
+        #     custom key events that may be created per property.
+        # @!attribute [rw] counting_method
+        #   @return [::Google::Analytics::Admin::V1alpha::KeyEvent::CountingMethod]
+        #     Required. The method by which Key Events will be counted across multiple
+        #     events within a session.
+        # @!attribute [rw] default_value
+        #   @return [::Google::Analytics::Admin::V1alpha::KeyEvent::DefaultValue]
+        #     Optional. Defines a default value/currency for a key event.
+        class KeyEvent
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Defines a default value/currency for a key event.
+          # @!attribute [rw] numeric_value
+          #   @return [::Float]
+          #     Required. This will be used to populate the "value" parameter for all
+          #     occurrences of this Key Event (specified by event_name) where that
+          #     parameter is unset.
+          # @!attribute [rw] currency_code
+          #   @return [::String]
+          #     Required. When an occurrence of this Key Event (specified by event_name)
+          #     has no set currency this currency will be applied as the default. Must be
+          #     in ISO 4217 currency code format.
+          #
+          #     See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+          class DefaultValue
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The method by which Key Events will be counted across multiple events
+          # within a session.
+          module CountingMethod
+            # Counting method not specified.
+            COUNTING_METHOD_UNSPECIFIED = 0
+
+            # Each Event instance is considered a Key Event.
+            ONCE_PER_EVENT = 1
+
+            # An Event instance is considered a Key Event at most once per session per
+            # user.
+            ONCE_PER_SESSION = 2
+          end
+        end
+
         # Settings values for Google Signals.  This is a singleton resource.
         # @!attribute [r] name
         #   @return [::String]
@@ -1358,6 +1430,11 @@ module Google
         # @!attribute [rw] excluded_events
         #   @return [::Array<::String>]
         #     The list of event names that will be excluded from exports.
+        # @!attribute [rw] dataset_location
+        #   @return [::String]
+        #     Required. Immutable. The geographic location where the created BigQuery
+        #     dataset should reside. See https://cloud.google.com/bigquery/docs/locations
+        #     for supported locations.
         class BigQueryLink
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1680,6 +1757,9 @@ module Google
           # ChannelGroup resource
           CHANNEL_GROUP = 22
 
+          # BigQuery link resource
+          BIGQUERY_LINK = 23
+
           # EnhancedMeasurementSettings resource
           ENHANCED_MEASUREMENT_SETTINGS = 24
 

data/proto_docs/google/api/client.rb

@@ -118,6 +118,10 @@ module Google
     #   @return [::String]
     #     Optional link to proto reference documentation.  Example:
     #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
+    # @!attribute [rw] rest_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to REST reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rest
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -286,6 +290,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -294,17 +305,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -313,8 +321,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See