google-apis-analyticsdata_v1beta 0.31.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c496cd3fff9ba1555c1da12dc509f99662e646a600b81eefbc728da18b7c02f4
-  data.tar.gz: aed5212273e635be3477c673ca2b9e15911d01c34e2bbfc820f7801c0a822503
+  metadata.gz: 4a973a5d0cebc05b0c7ea297daa6479dd5d7218c4865e538475c665bf4fe9aae
+  data.tar.gz: a7df927367a62236b8062d8f782771378c1e4dae79fb53ba6394d53a67559a89
 SHA512:
-  metadata.gz: 7f8455b3255742a3890cff1636bcc68ea715d2c963961132c5f55b648c091388ce1738d1cacc2d3611a8dd3eefb484dc9695e71bf523200ef1bc725c9f0c1710
-  data.tar.gz: d3231d8bae9bf5ed1976664ab9399e65b2d9bebd6e2b7173b5cbe57bc387e789034a9281a2fce1140a86f3cf24ada3b000ebc12684edb11698d384bb0056391c
+  metadata.gz: bb8fea9eb10a5f40600a145de68641a74be022d72ac02bc6aa134502a6fc7a974fcc49611796fbb4073d4535cf2c4ac2d4671cea088bab856cab30cb2f5f66fa
+  data.tar.gz: 6377e9a1d86045a3c110d1328ab133a04f945b9a9e2997bad9d8fd7d079687ee7491b51e877e36d51f6dd5e89b68c47ccd850f693d972b33e40476eac51ff685

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-analyticsdata_v1beta
 
+### v0.32.0 (2023-12-10)
+
+* Regenerated from discovery document revision 20231203
+
 ### v0.31.0 (2023-11-12)
 
 * Regenerated from discovery document revision 20231105

data/lib/google/apis/analyticsdata_v1beta/classes.rb

@@ -47,6 +47,92 @@ module Google
         end
       end
       
+      # An audience export is a list of users in an audience at the time of the list's
+      # creation. One audience may have multiple audience exports created for
+      # different days.
+      class AudienceExport
+        include Google::Apis::Core::Hashable
+      
+        # Required. The audience resource name. This resource name identifies the
+        # audience being listed and is shared between the Analytics Data & Admin APIs.
+        # Format: `properties/`property`/audiences/`audience``
+        # Corresponds to the JSON property `audience`
+        # @return [String]
+        attr_accessor :audience
+      
+        # Output only. The descriptive display name for this audience. For example, "
+        # Purchasers".
+        # Corresponds to the JSON property `audienceDisplayName`
+        # @return [String]
+        attr_accessor :audience_display_name
+      
+        # Output only. The time when CreateAudienceExport was called and the
+        # AudienceExport began the `CREATING` state.
+        # Corresponds to the JSON property `beginCreatingTime`
+        # @return [String]
+        attr_accessor :begin_creating_time
+      
+        # Output only. The total quota tokens charged during creation of the
+        # AudienceExport. Because this token count is based on activity from the `
+        # CREATING` state, this tokens charged will be fixed once an AudienceExport
+        # enters the `ACTIVE` or `FAILED` states.
+        # Corresponds to the JSON property `creationQuotaTokensCharged`
+        # @return [Fixnum]
+        attr_accessor :creation_quota_tokens_charged
+      
+        # Required. The dimensions requested and displayed in the query response.
+        # Corresponds to the JSON property `dimensions`
+        # @return [Array<Google::Apis::AnalyticsdataV1beta::V1betaAudienceDimension>]
+        attr_accessor :dimensions
+      
+        # Output only. Error message is populated when an audience export fails during
+        # creation. A common reason for such a failure is quota exhaustion.
+        # Corresponds to the JSON property `errorMessage`
+        # @return [String]
+        attr_accessor :error_message
+      
+        # Output only. Identifier. The audience export resource name assigned during
+        # creation. This resource name identifies this `AudienceExport`. Format: `
+        # properties/`property`/audienceExports/`audience_export``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The percentage completed for this audience export ranging between
+        # 0 to 100.
+        # Corresponds to the JSON property `percentageCompleted`
+        # @return [Float]
+        attr_accessor :percentage_completed
+      
+        # Output only. The total number of rows in the AudienceExport result.
+        # Corresponds to the JSON property `rowCount`
+        # @return [Fixnum]
+        attr_accessor :row_count
+      
+        # Output only. The current state for this AudienceExport.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @audience = args[:audience] if args.key?(:audience)
+          @audience_display_name = args[:audience_display_name] if args.key?(:audience_display_name)
+          @begin_creating_time = args[:begin_creating_time] if args.key?(:begin_creating_time)
+          @creation_quota_tokens_charged = args[:creation_quota_tokens_charged] if args.key?(:creation_quota_tokens_charged)
+          @dimensions = args[:dimensions] if args.key?(:dimensions)
+          @error_message = args[:error_message] if args.key?(:error_message)
+          @name = args[:name] if args.key?(:name)
+          @percentage_completed = args[:percentage_completed] if args.key?(:percentage_completed)
+          @row_count = args[:row_count] if args.key?(:row_count)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # This metadata is currently blank.
       class AudienceListMetadata
         include Google::Apis::Core::Hashable
@@ -854,6 +940,32 @@ module Google
         end
       end
       
+      # A list of all audience exports for a property.
+      class ListAudienceExportsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Each audience export for a property.
+        # Corresponds to the JSON property `audienceExports`
+        # @return [Array<Google::Apis::AnalyticsdataV1beta::AudienceExport>]
+        attr_accessor :audience_exports
+      
+        # A token, which can be sent as `page_token` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @audience_exports = args[:audience_exports] if args.key?(:audience_exports)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The dimensions, metrics and comparisons currently accepted in reporting
       # methods.
       class Metadata
@@ -1205,6 +1317,68 @@ module Google
         end
       end
       
+      # This resource represents a long-running operation that is the result of a
+      # network API call.
+      class Operation
+        include Google::Apis::Core::Hashable
+      
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
+        # Corresponds to the JSON property `done`
+        # @return [Boolean]
+        attr_accessor :done
+        alias_method :done?, :done
+      
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
+        # Corresponds to the JSON property `error`
+        # @return [Google::Apis::AnalyticsdataV1beta::Status]
+        attr_accessor :error
+      
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+      
+        # The server-assigned name, which is only unique within the same service that
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The normal, successful response of the operation. If the original method
+        # returns no data on success, such as `Delete`, the response is `google.protobuf.
+        # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
+        # response should be the resource. For other methods, the response should have
+        # the type `XxxResponse`, where `Xxx` is the original method name. For example,
+        # if the original method name is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
+        # Corresponds to the JSON property `response`
+        # @return [Hash<String,Object>]
+        attr_accessor :response
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @done = args[:done] if args.key?(:done)
+          @error = args[:error] if args.key?(:error)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+          @response = args[:response] if args.key?(:response)
+        end
+      end
+      
       # Order bys define how rows will be sorted in the response. For example,
       # ordering rows by descending event count is one ordering, and ordering rows by
       # the event name string is a different ordering.
@@ -1460,6 +1634,83 @@ module Google
         end
       end
       
+      # A request to list users in an audience export.
+      class QueryAudienceExportRequest
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The number of rows to return. If unspecified, 10,000 rows are
+        # returned. The API returns a maximum of 250,000 rows per request, no matter how
+        # many you ask for. `limit` must be positive. The API can also return fewer rows
+        # than the requested `limit`, if there aren't as many dimension values as the `
+        # limit`. To learn more about this pagination parameter, see [Pagination](https:/
+        # /developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination)
+        # .
+        # Corresponds to the JSON property `limit`
+        # @return [Fixnum]
+        attr_accessor :limit
+      
+        # Optional. The row count of the start row. The first row is counted as row 0.
+        # When paging, the first request does not specify offset; or equivalently, sets
+        # offset to 0; the first request returns the first `limit` of rows. The second
+        # request sets offset to the `limit` of the first request; the second request
+        # returns the second `limit` of rows. To learn more about this pagination
+        # parameter, see [Pagination](https://developers.google.com/analytics/devguides/
+        # reporting/data/v1/basics#pagination).
+        # Corresponds to the JSON property `offset`
+        # @return [Fixnum]
+        attr_accessor :offset
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @limit = args[:limit] if args.key?(:limit)
+          @offset = args[:offset] if args.key?(:offset)
+        end
+      end
+      
+      # A list of users in an audience export.
+      class QueryAudienceExportResponse
+        include Google::Apis::Core::Hashable
+      
+        # An audience export is a list of users in an audience at the time of the list's
+        # creation. One audience may have multiple audience exports created for
+        # different days.
+        # Corresponds to the JSON property `audienceExport`
+        # @return [Google::Apis::AnalyticsdataV1beta::AudienceExport]
+        attr_accessor :audience_export
+      
+        # Rows for each user in an audience export. The number of rows in this response
+        # will be less than or equal to request's page size.
+        # Corresponds to the JSON property `audienceRows`
+        # @return [Array<Google::Apis::AnalyticsdataV1beta::V1betaAudienceRow>]
+        attr_accessor :audience_rows
+      
+        # The total number of rows in the AudienceExport result. `rowCount` is
+        # independent of the number of rows returned in the response, the `limit`
+        # request parameter, and the `offset` request parameter. For example if a query
+        # returns 175 rows and includes `limit` of 50 in the API request, the response
+        # will contain `rowCount` of 175 but only 50 rows. To learn more about this
+        # pagination parameter, see [Pagination](https://developers.google.com/analytics/
+        # devguides/reporting/data/v1/basics#pagination).
+        # Corresponds to the JSON property `rowCount`
+        # @return [Fixnum]
+        attr_accessor :row_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @audience_export = args[:audience_export] if args.key?(:audience_export)
+          @audience_rows = args[:audience_rows] if args.key?(:audience_rows)
+          @row_count = args[:row_count] if args.key?(:row_count)
+        end
+      end
+      
       # Current state for a particular quota group.
       class QuotaStatus
         include Google::Apis::Core::Hashable
@@ -2243,6 +2494,45 @@ module Google
         end
       end
       
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
+      class Status
+        include Google::Apis::Core::Hashable
+      
+        # The status code, which should be an enum value of google.rpc.Code.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # A list of messages that carry the error details. There is a common set of
+        # message types for APIs to use.
+        # Corresponds to the JSON property `details`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :details
+      
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @details = args[:details] if args.key?(:details)
+          @message = args[:message] if args.key?(:message)
+        end
+      end
+      
       # The filter for string
       class StringFilter
         include Google::Apis::Core::Hashable
@@ -2274,6 +2564,67 @@ module Google
           @value = args[:value] if args.key?(:value)
         end
       end
+      
+      # An audience dimension is a user attribute. Specific user attributed are
+      # requested and then later returned in the `QueryAudienceExportResponse`.
+      class V1betaAudienceDimension
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The API name of the dimension. See the [API Dimensions](https://
+        # developers.google.com/analytics/devguides/reporting/data/v1/audience-list-api-
+        # schema#dimensions) for the list of dimension names.
+        # Corresponds to the JSON property `dimensionName`
+        # @return [String]
+        attr_accessor :dimension_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dimension_name = args[:dimension_name] if args.key?(:dimension_name)
+        end
+      end
+      
+      # The value of a dimension.
+      class V1betaAudienceDimensionValue
+        include Google::Apis::Core::Hashable
+      
+        # Value as a string if the dimension type is a string.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # Dimension value attributes for the audience user row.
+      class V1betaAudienceRow
+        include Google::Apis::Core::Hashable
+      
+        # Each dimension value attribute for an audience user. One dimension value will
+        # be added for each dimension column requested.
+        # Corresponds to the JSON property `dimensionValues`
+        # @return [Array<Google::Apis::AnalyticsdataV1beta::V1betaAudienceDimensionValue>]
+        attr_accessor :dimension_values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dimension_values = args[:dimension_values] if args.key?(:dimension_values)
+        end
+      end
     end
   end
 end

data/lib/google/apis/analyticsdata_v1beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module AnalyticsdataV1beta
       # Version of the google-apis-analyticsdata_v1beta gem
-      GEM_VERSION = "0.31.0"
+      GEM_VERSION = "0.32.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231105"
+      REVISION = "20231203"
     end
   end
 end

data/lib/google/apis/analyticsdata_v1beta/representations.rb

@@ -28,6 +28,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AudienceExport
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AudienceListMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -184,6 +190,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListAudienceExportsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Metadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -244,6 +256,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Operation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class OrderBy
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -286,6 +304,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class QueryAudienceExportRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class QueryAudienceExportResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class QuotaStatus
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -352,12 +382,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Status
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class StringFilter
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class V1betaAudienceDimension
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class V1betaAudienceDimensionValue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class V1betaAudienceRow
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ActiveMetricRestriction
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -366,6 +420,23 @@ module Google
         end
       end
       
+      class AudienceExport
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :audience, as: 'audience'
+          property :audience_display_name, as: 'audienceDisplayName'
+          property :begin_creating_time, as: 'beginCreatingTime'
+          property :creation_quota_tokens_charged, as: 'creationQuotaTokensCharged'
+          collection :dimensions, as: 'dimensions', class: Google::Apis::AnalyticsdataV1beta::V1betaAudienceDimension, decorator: Google::Apis::AnalyticsdataV1beta::V1betaAudienceDimension::Representation
+      
+          property :error_message, as: 'errorMessage'
+          property :name, as: 'name'
+          property :percentage_completed, as: 'percentageCompleted'
+          property :row_count, as: 'rowCount'
+          property :state, as: 'state'
+        end
+      end
+      
       class AudienceListMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -612,6 +683,15 @@ module Google
         end
       end
       
+      class ListAudienceExportsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :audience_exports, as: 'audienceExports', class: Google::Apis::AnalyticsdataV1beta::AudienceExport, decorator: Google::Apis::AnalyticsdataV1beta::AudienceExport::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class Metadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -704,6 +784,18 @@ module Google
         end
       end
       
+      class Operation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :done, as: 'done'
+          property :error, as: 'error', class: Google::Apis::AnalyticsdataV1beta::Status, decorator: Google::Apis::AnalyticsdataV1beta::Status::Representation
+      
+          hash :metadata, as: 'metadata'
+          property :name, as: 'name'
+          hash :response, as: 'response'
+        end
+      end
+      
       class OrderBy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -781,6 +873,25 @@ module Google
         end
       end
       
+      class QueryAudienceExportRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :limit, :numeric_string => true, as: 'limit'
+          property :offset, :numeric_string => true, as: 'offset'
+        end
+      end
+      
+      class QueryAudienceExportResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :audience_export, as: 'audienceExport', class: Google::Apis::AnalyticsdataV1beta::AudienceExport, decorator: Google::Apis::AnalyticsdataV1beta::AudienceExport::Representation
+      
+          collection :audience_rows, as: 'audienceRows', class: Google::Apis::AnalyticsdataV1beta::V1betaAudienceRow, decorator: Google::Apis::AnalyticsdataV1beta::V1betaAudienceRow::Representation
+      
+          property :row_count, as: 'rowCount'
+        end
+      end
+      
       class QuotaStatus
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -969,6 +1080,15 @@ module Google
         end
       end
       
+      class Status
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          collection :details, as: 'details'
+          property :message, as: 'message'
+        end
+      end
+      
       class StringFilter
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -977,6 +1097,28 @@ module Google
           property :value, as: 'value'
         end
       end
+      
+      class V1betaAudienceDimension
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :dimension_name, as: 'dimensionName'
+        end
+      end
+      
+      class V1betaAudienceDimensionValue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :value, as: 'value'
+        end
+      end
+      
+      class V1betaAudienceRow
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :dimension_values, as: 'dimensionValues', class: Google::Apis::AnalyticsdataV1beta::V1betaAudienceDimensionValue, decorator: Google::Apis::AnalyticsdataV1beta::V1betaAudienceDimensionValue::Representation
+      
+        end
+      end
     end
   end
 end

data/lib/google/apis/analyticsdata_v1beta/service.rb

@@ -345,6 +345,195 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Creates an audience export for later retrieval. This method quickly returns
+        # the audience export's resource name and initiates a long running asynchronous
+        # request to form an audience export. To export the users in an audience export,
+        # first create the audience export through this method and then send the
+        # audience resource name to the `QueryAudienceExport` method. See [Creating an
+        # Audience Export](https://developers.google.com/analytics/devguides/reporting/
+        # data/v1/audience-list-basics) for an introduction to Audience Exports with
+        # examples. An audience export is a snapshot of the users currently in the
+        # audience at the time of audience export creation. Creating audience exports
+        # for one audience on different days will return different results as users
+        # enter and exit the audience. Audiences in Google Analytics 4 allow you to
+        # segment your users in the ways that are important to your business. To learn
+        # more, see https://support.google.com/analytics/answer/9267572. Audience
+        # exports contain the users in each audience. Audience Export APIs have some
+        # methods at alpha and other methods at beta stability. The intention is to
+        # advance methods to beta stability after some feedback and adoption. To give
+        # your feedback on this API, complete the [Google Analytics Audience Export API
+        # Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
+        # @param [String] parent
+        #   Required. The parent resource where this audience export will be created.
+        #   Format: `properties/`property``
+        # @param [Google::Apis::AnalyticsdataV1beta::AudienceExport] audience_export_object
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1beta::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1beta::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_property_audience_export(parent, audience_export_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+parent}/audienceExports', options)
+          command.request_representation = Google::Apis::AnalyticsdataV1beta::AudienceExport::Representation
+          command.request_object = audience_export_object
+          command.response_representation = Google::Apis::AnalyticsdataV1beta::Operation::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1beta::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets configuration metadata about a specific audience export. This method can
+        # be used to understand an audience export after it has been created. See [
+        # Creating an Audience Export](https://developers.google.com/analytics/devguides/
+        # reporting/data/v1/audience-list-basics) for an introduction to Audience
+        # Exports with examples. Audience Export APIs have some methods at alpha and
+        # other methods at beta stability. The intention is to advance methods to beta
+        # stability after some feedback and adoption. To give your feedback on this API,
+        # complete the [Google Analytics Audience Export API Feedback](https://forms.gle/
+        # EeA5u5LW6PEggtCEA) form.
+        # @param [String] name
+        #   Required. The audience export resource name. Format: `properties/`property`/
+        #   audienceExports/`audience_export``
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1beta::AudienceExport] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1beta::AudienceExport]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_property_audience_export(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta/{+name}', options)
+          command.response_representation = Google::Apis::AnalyticsdataV1beta::AudienceExport::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1beta::AudienceExport
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all audience exports for a property. This method can be used for you to
+        # find and reuse existing audience exports rather than creating unnecessary new
+        # audience exports. The same audience can have multiple audience exports that
+        # represent the export of users that were in an audience on different days. See [
+        # Creating an Audience Export](https://developers.google.com/analytics/devguides/
+        # reporting/data/v1/audience-list-basics) for an introduction to Audience
+        # Exports with examples. Audience Export APIs have some methods at alpha and
+        # other methods at beta stability. The intention is to advance methods to beta
+        # stability after some feedback and adoption. To give your feedback on this API,
+        # complete the [Google Analytics Audience Export API Feedback](https://forms.gle/
+        # EeA5u5LW6PEggtCEA) form.
+        # @param [String] parent
+        #   Required. All audience exports for this property will be listed in the
+        #   response. Format: `properties/`property``
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of audience exports to return. The service may
+        #   return fewer than this value. If unspecified, at most 200 audience exports
+        #   will be returned. The maximum value is 1000 (higher values will be coerced to
+        #   the maximum).
+        # @param [String] page_token
+        #   Optional. A page token, received from a previous `ListAudienceExports` call.
+        #   Provide this to retrieve the subsequent page. When paginating, all other
+        #   parameters provided to `ListAudienceExports` must match the call that provided
+        #   the page token.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1beta::ListAudienceExportsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1beta::ListAudienceExportsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_property_audience_exports(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta/{+parent}/audienceExports', options)
+          command.response_representation = Google::Apis::AnalyticsdataV1beta::ListAudienceExportsResponse::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1beta::ListAudienceExportsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Retrieves an audience export of users. After creating an audience, the users
+        # are not immediately available for exporting. First, a request to `
+        # CreateAudienceExport` is necessary to create an audience export of users, and
+        # then second, this method is used to retrieve the users in the audience export.
+        # See [Creating an Audience Export](https://developers.google.com/analytics/
+        # devguides/reporting/data/v1/audience-list-basics) for an introduction to
+        # Audience Exports with examples. Audiences in Google Analytics 4 allow you to
+        # segment your users in the ways that are important to your business. To learn
+        # more, see https://support.google.com/analytics/answer/9267572. Audience Export
+        # APIs have some methods at alpha and other methods at beta stability. The
+        # intention is to advance methods to beta stability after some feedback and
+        # adoption. To give your feedback on this API, complete the [Google Analytics
+        # Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
+        # @param [String] name
+        #   Required. The name of the audience export to retrieve users from. Format: `
+        #   properties/`property`/audienceExports/`audience_export``
+        # @param [Google::Apis::AnalyticsdataV1beta::QueryAudienceExportRequest] query_audience_export_request_object
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1beta::QueryAudienceExportResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1beta::QueryAudienceExportResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def query_audience_export(name, query_audience_export_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+name}:query', options)
+          command.request_representation = Google::Apis::AnalyticsdataV1beta::QueryAudienceExportRequest::Representation
+          command.request_object = query_audience_export_request_object
+          command.response_representation = Google::Apis::AnalyticsdataV1beta::QueryAudienceExportResponse::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1beta::QueryAudienceExportResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-analyticsdata_v1beta
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.32.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-12 00:00:00.000000000 Z
+date: 2023-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-analyticsdata_v1beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-analyticsdata_v1beta/v0.31.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-analyticsdata_v1beta/v0.32.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-analyticsdata_v1beta
 post_install_message: 
 rdoc_options: []