google-ads-marketing_platform-admin-v1alpha 0.2.1 → 0.3.0

data/lib/google/ads/marketing_platform/admin/v1alpha/marketingplatform_admin_service/rest/client.rb

@@ -261,6 +261,185 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
+                ##
+                # Returns a list of organizations that the user has access to.
+                #
+                # @overload list_organizations(request, options = nil)
+                #   Pass arguments to `list_organizations` via a request object, either of type
+                #   {::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsRequest, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @overload list_organizations(page_size: nil, page_token: nil)
+                #   Pass arguments to `list_organizations` via keyword arguments. Note that at
+                #   least one keyword argument is required. To specify no parameters, or to keep all
+                #   the default parameter values, pass an empty Hash as a request object (see above).
+                #
+                #   @param page_size [::Integer]
+                #     Optional. The maximum number of organizations to return in one call. The
+                #     service may return fewer than this value.
+                #
+                #     If unspecified, at most 50 organizations will be returned. The
+                #     maximum value is 1000; values above 1000 will be coerced to 1000.
+                #   @param page_token [::String]
+                #     Optional. A page token, received from a previous ListOrganizations call.
+                #     Provide this to retrieve the subsequent page.
+                #
+                #     When paginating, all other parameters provided to
+                #     `ListOrganizations` must match the call that provided the page
+                #     token.
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Ads::MarketingPlatform::Admin::V1alpha::Organization>]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Gapic::Rest::PagedEnumerable<::Google::Ads::MarketingPlatform::Admin::V1alpha::Organization>]
+                #
+                # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/ads/marketing_platform/admin/v1alpha"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Ads::MarketingPlatform::Admin::V1alpha::MarketingplatformAdminService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsRequest.new
+                #
+                #   # Call the list_organizations method.
+                #   result = client.list_organizations request
+                #
+                #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+                #   # over elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Ads::MarketingPlatform::Admin::V1alpha::Organization.
+                #     p item
+                #   end
+                #
+                def list_organizations request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsRequest
+
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                  # Customize the options with defaults
+                  call_metadata = @config.rpcs.list_organizations.metadata.to_h
+
+                  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Ads::MarketingPlatform::Admin::V1alpha::VERSION,
+                    transports_version_send: [:rest]
+
+                  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                  options.apply_defaults timeout:      @config.rpcs.list_organizations.timeout,
+                                         metadata:     call_metadata,
+                                         retry_policy: @config.rpcs.list_organizations.retry_policy
+
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @marketingplatform_admin_service_stub.list_organizations request, options do |result, operation|
+                    result = ::Gapic::Rest::PagedEnumerable.new @marketingplatform_admin_service_stub, :list_organizations, "organizations", request, result, options
+                    yield result, operation if block_given?
+                    throw :response, result
+                  end
+                rescue ::Gapic::Rest::Error => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
+
+                ##
+                # Returns a list of clients managed by the sales partner organization.
+                #
+                # User needs to be an OrgAdmin/BillingAdmin on the sales partner organization
+                # in order to view the end clients.
+                #
+                # @overload find_sales_partner_managed_clients(request, options = nil)
+                #   Pass arguments to `find_sales_partner_managed_clients` via a request object, either of type
+                #   {::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsRequest, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @overload find_sales_partner_managed_clients(organization: nil, is_active: nil)
+                #   Pass arguments to `find_sales_partner_managed_clients` via keyword arguments. Note that at
+                #   least one keyword argument is required. To specify no parameters, or to keep all
+                #   the default parameter values, pass an empty Hash as a request object (see above).
+                #
+                #   @param organization [::String]
+                #     Required. The name of the sales partner organization.
+                #     Format: organizations/\\{org_id}
+                #   @param is_active [::Boolean]
+                #     Optional. If set, only active and just ended clients will be returned.
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsResponse]
+                #
+                # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/ads/marketing_platform/admin/v1alpha"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Ads::MarketingPlatform::Admin::V1alpha::MarketingplatformAdminService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsRequest.new
+                #
+                #   # Call the find_sales_partner_managed_clients method.
+                #   result = client.find_sales_partner_managed_clients request
+                #
+                #   # The returned object is of type Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsResponse.
+                #   p result
+                #
+                def find_sales_partner_managed_clients request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsRequest
+
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                  # Customize the options with defaults
+                  call_metadata = @config.rpcs.find_sales_partner_managed_clients.metadata.to_h
+
+                  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Ads::MarketingPlatform::Admin::V1alpha::VERSION,
+                    transports_version_send: [:rest]
+
+                  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                  options.apply_defaults timeout:      @config.rpcs.find_sales_partner_managed_clients.timeout,
+                                         metadata:     call_metadata,
+                                         retry_policy: @config.rpcs.find_sales_partner_managed_clients.retry_policy
+
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @marketingplatform_admin_service_stub.find_sales_partner_managed_clients request, options do |result, operation|
+                    yield result, operation if block_given?
+                  end
+                rescue ::Gapic::Rest::Error => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
+
                 ##
                 # Lists the Google Analytics accounts link to the specified Google Marketing
                 # Platform organization.
@@ -617,6 +796,99 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
+                ##
+                # Get the usage and billing data for properties within the organization for
+                # the specified month.
+                #
+                # Per direct client org, user needs to be OrgAdmin/BillingAdmin on the
+                # organization in order to view the billing and usage data.
+                #
+                # Per sales partner client org, user needs to be OrgAdmin/BillingAdmin on
+                # the sales partner org in order to view the billing and usage data, or
+                # OrgAdmin/BillingAdmin on the sales partner client org in order to view the
+                # usage data only.
+                #
+                # @overload report_property_usage(request, options = nil)
+                #   Pass arguments to `report_property_usage` via a request object, either of type
+                #   {::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageRequest, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @overload report_property_usage(organization: nil, month: nil)
+                #   Pass arguments to `report_property_usage` via keyword arguments. Note that at
+                #   least one keyword argument is required. To specify no parameters, or to keep all
+                #   the default parameter values, pass an empty Hash as a request object (see above).
+                #
+                #   @param organization [::String]
+                #     Required. Specifies the organization whose property usage will be listed.
+                #
+                #     Format: organizations/\\{org_id}
+                #   @param month [::String]
+                #     Required. The target month to list property usages.
+                #
+                #     Format: YYYY-MM. For example, "2025-05"
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageResponse]
+                #
+                # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/ads/marketing_platform/admin/v1alpha"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Ads::MarketingPlatform::Admin::V1alpha::MarketingplatformAdminService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageRequest.new
+                #
+                #   # Call the report_property_usage method.
+                #   result = client.report_property_usage request
+                #
+                #   # The returned object is of type Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageResponse.
+                #   p result
+                #
+                def report_property_usage request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageRequest
+
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                  # Customize the options with defaults
+                  call_metadata = @config.rpcs.report_property_usage.metadata.to_h
+
+                  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Ads::MarketingPlatform::Admin::V1alpha::VERSION,
+                    transports_version_send: [:rest]
+
+                  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                  options.apply_defaults timeout:      @config.rpcs.report_property_usage.timeout,
+                                         metadata:     call_metadata,
+                                         retry_policy: @config.rpcs.report_property_usage.retry_policy
+
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @marketingplatform_admin_service_stub.report_property_usage request, options do |result, operation|
+                    yield result, operation if block_given?
+                  end
+                rescue ::Gapic::Rest::Error => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
+
                 ##
                 # Configuration class for the MarketingplatformAdminService REST API.
                 #
@@ -769,6 +1041,16 @@ module Google
                     #
                     attr_reader :get_organization
                     ##
+                    # RPC-specific configuration for `list_organizations`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :list_organizations
+                    ##
+                    # RPC-specific configuration for `find_sales_partner_managed_clients`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :find_sales_partner_managed_clients
+                    ##
                     # RPC-specific configuration for `list_analytics_account_links`
                     # @return [::Gapic::Config::Method]
                     #
@@ -788,11 +1070,20 @@ module Google
                     # @return [::Gapic::Config::Method]
                     #
                     attr_reader :set_property_service_level
+                    ##
+                    # RPC-specific configuration for `report_property_usage`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :report_property_usage
 
                     # @private
                     def initialize parent_rpcs = nil
                       get_organization_config = parent_rpcs.get_organization if parent_rpcs.respond_to? :get_organization
                       @get_organization = ::Gapic::Config::Method.new get_organization_config
+                      list_organizations_config = parent_rpcs.list_organizations if parent_rpcs.respond_to? :list_organizations
+                      @list_organizations = ::Gapic::Config::Method.new list_organizations_config
+                      find_sales_partner_managed_clients_config = parent_rpcs.find_sales_partner_managed_clients if parent_rpcs.respond_to? :find_sales_partner_managed_clients
+                      @find_sales_partner_managed_clients = ::Gapic::Config::Method.new find_sales_partner_managed_clients_config
                       list_analytics_account_links_config = parent_rpcs.list_analytics_account_links if parent_rpcs.respond_to? :list_analytics_account_links
                       @list_analytics_account_links = ::Gapic::Config::Method.new list_analytics_account_links_config
                       create_analytics_account_link_config = parent_rpcs.create_analytics_account_link if parent_rpcs.respond_to? :create_analytics_account_link
@@ -801,6 +1092,8 @@ module Google
                       @delete_analytics_account_link = ::Gapic::Config::Method.new delete_analytics_account_link_config
                       set_property_service_level_config = parent_rpcs.set_property_service_level if parent_rpcs.respond_to? :set_property_service_level
                       @set_property_service_level = ::Gapic::Config::Method.new set_property_service_level_config
+                      report_property_usage_config = parent_rpcs.report_property_usage if parent_rpcs.respond_to? :report_property_usage
+                      @report_property_usage = ::Gapic::Config::Method.new report_property_usage_config
 
                       yield self if block_given?
                     end

data/lib/google/ads/marketing_platform/admin/v1alpha/marketingplatform_admin_service/rest/service_stub.rb

@@ -114,6 +114,86 @@ module Google
                   end
                 end
 
+                ##
+                # Baseline implementation for the list_organizations REST call
+                #
+                # @param request_pb [::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsRequest]
+                #   A request object representing the call parameters. Required.
+                # @param options [::Gapic::CallOptions]
+                #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsResponse]
+                #   A result object deserialized from the server's reply
+                def list_organizations request_pb, options = nil
+                  raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                  verb, uri, query_string_params, body = ServiceStub.transcode_list_organizations_request request_pb
+                  query_string_params = if query_string_params.any?
+                                          query_string_params.to_h { |p| p.split "=", 2 }
+                                        else
+                                          {}
+                                        end
+
+                  response = @client_stub.make_http_request(
+                    verb,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "list_organizations",
+                    options: options
+                  )
+                  operation = ::Gapic::Rest::TransportOperation.new response
+                  result = ::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsResponse.decode_json response.body, ignore_unknown_fields: true
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
+                end
+
+                ##
+                # Baseline implementation for the find_sales_partner_managed_clients REST call
+                #
+                # @param request_pb [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsRequest]
+                #   A request object representing the call parameters. Required.
+                # @param options [::Gapic::CallOptions]
+                #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsResponse]
+                #   A result object deserialized from the server's reply
+                def find_sales_partner_managed_clients request_pb, options = nil
+                  raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                  verb, uri, query_string_params, body = ServiceStub.transcode_find_sales_partner_managed_clients_request request_pb
+                  query_string_params = if query_string_params.any?
+                                          query_string_params.to_h { |p| p.split "=", 2 }
+                                        else
+                                          {}
+                                        end
+
+                  response = @client_stub.make_http_request(
+                    verb,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "find_sales_partner_managed_clients",
+                    options: options
+                  )
+                  operation = ::Gapic::Rest::TransportOperation.new response
+                  result = ::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsResponse.decode_json response.body, ignore_unknown_fields: true
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
+                end
+
                 ##
                 # Baseline implementation for the list_analytics_account_links REST call
                 #
@@ -274,6 +354,46 @@ module Google
                   end
                 end
 
+                ##
+                # Baseline implementation for the report_property_usage REST call
+                #
+                # @param request_pb [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageRequest]
+                #   A request object representing the call parameters. Required.
+                # @param options [::Gapic::CallOptions]
+                #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageResponse]
+                #   A result object deserialized from the server's reply
+                def report_property_usage request_pb, options = nil
+                  raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                  verb, uri, query_string_params, body = ServiceStub.transcode_report_property_usage_request request_pb
+                  query_string_params = if query_string_params.any?
+                                          query_string_params.to_h { |p| p.split "=", 2 }
+                                        else
+                                          {}
+                                        end
+
+                  response = @client_stub.make_http_request(
+                    verb,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "report_property_usage",
+                    options: options
+                  )
+                  operation = ::Gapic::Rest::TransportOperation.new response
+                  result = ::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageResponse.decode_json response.body, ignore_unknown_fields: true
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
+                end
+
                 ##
                 # @private
                 #
@@ -295,6 +415,47 @@ module Google
                   transcoder.transcode request_pb
                 end
 
+                ##
+                # @private
+                #
+                # GRPC transcoding helper method for the list_organizations REST call
+                #
+                # @param request_pb [::Google::Ads::MarketingPlatform::Admin::V1alpha::ListOrganizationsRequest]
+                #   A request object representing the call parameters. Required.
+                # @return [Array(String, [String, nil], Hash{String => String})]
+                #   Uri, Body, Query string parameters
+                def self.transcode_list_organizations_request request_pb
+                  transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                          .with_bindings(
+                                                            uri_method: :get,
+                                                            uri_template: "/v1alpha/organizations",
+                                                            matches: []
+                                                          )
+                  transcoder.transcode request_pb
+                end
+
+                ##
+                # @private
+                #
+                # GRPC transcoding helper method for the find_sales_partner_managed_clients REST call
+                #
+                # @param request_pb [::Google::Ads::MarketingPlatform::Admin::V1alpha::FindSalesPartnerManagedClientsRequest]
+                #   A request object representing the call parameters. Required.
+                # @return [Array(String, [String, nil], Hash{String => String})]
+                #   Uri, Body, Query string parameters
+                def self.transcode_find_sales_partner_managed_clients_request request_pb
+                  transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                          .with_bindings(
+                                                            uri_method: :post,
+                                                            uri_template: "/v1alpha/{organization}:findSalesPartnerManagedClients",
+                                                            body: "*",
+                                                            matches: [
+                                                              ["organization", %r{^organizations/[^/]+/?$}, false]
+                                                            ]
+                                                          )
+                  transcoder.transcode request_pb
+                end
+
                 ##
                 # @private
                 #
@@ -380,6 +541,28 @@ module Google
                                                           )
                   transcoder.transcode request_pb
                 end
+
+                ##
+                # @private
+                #
+                # GRPC transcoding helper method for the report_property_usage REST call
+                #
+                # @param request_pb [::Google::Ads::MarketingPlatform::Admin::V1alpha::ReportPropertyUsageRequest]
+                #   A request object representing the call parameters. Required.
+                # @return [Array(String, [String, nil], Hash{String => String})]
+                #   Uri, Body, Query string parameters
+                def self.transcode_report_property_usage_request request_pb
+                  transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                          .with_bindings(
+                                                            uri_method: :post,
+                                                            uri_template: "/v1alpha/{organization}:reportPropertyUsage",
+                                                            body: "*",
+                                                            matches: [
+                                                              ["organization", %r{^organizations/[^/]+/?$}, false]
+                                                            ]
+                                                          )
+                  transcoder.transcode request_pb
+                end
               end
             end
           end

data/lib/google/ads/marketing_platform/admin/v1alpha/version.rb

@@ -22,7 +22,7 @@ module Google
     module MarketingPlatform
       module Admin
         module V1alpha
-          VERSION = "0.2.1"
+          VERSION = "0.3.0"
         end
       end
     end

data/lib/google/marketingplatform/admin/v1alpha/marketingplatform_admin_pb.rb

@@ -10,9 +10,11 @@ require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/marketingplatform/admin/v1alpha/resources_pb'
 require 'google/protobuf/empty_pb'
+require 'google/type/date_pb'
+require 'google/type/money_pb'
 
 
-descriptor_data = "\nDgoogle/marketingplatform/admin/v1alpha/marketingplatform_admin.proto\x12&google.marketingplatform.admin.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x36google/marketingplatform/admin/v1alpha/resources.proto\x1a\x1bgoogle/protobuf/empty.proto\"b\n\x16GetOrganizationRequest\x12H\n\x04name\x18\x01 \x01(\tB:\xe0\x41\x02\xfa\x41\x34\n2marketingplatformadmin.googleapis.com/Organization\"\xa7\x01\n ListAnalyticsAccountLinksRequest\x12R\n\x06parent\x18\x01 \x01(\tBB\xe0\x41\x02\xfa\x41<\x12:marketingplatformadmin.googleapis.com/AnalyticsAccountLink\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\"\x9b\x01\n!ListAnalyticsAccountLinksResponse\x12]\n\x17\x61nalytics_account_links\x18\x01 \x03(\x0b\x32<.google.marketingplatform.admin.v1alpha.AnalyticsAccountLink\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xda\x01\n!CreateAnalyticsAccountLinkRequest\x12R\n\x06parent\x18\x01 \x01(\tBB\xe0\x41\x02\xfa\x41<\x12:marketingplatformadmin.googleapis.com/AnalyticsAccountLink\x12\x61\n\x16\x61nalytics_account_link\x18\x02 \x01(\x0b\x32<.google.marketingplatform.admin.v1alpha.AnalyticsAccountLinkB\x03\xe0\x41\x02\"u\n!DeleteAnalyticsAccountLinkRequest\x12P\n\x04name\x18\x01 \x01(\tBB\xe0\x41\x02\xfa\x41<\n:marketingplatformadmin.googleapis.com/AnalyticsAccountLink\"\xec\x01\n\x1eSetPropertyServiceLevelRequest\x12#\n\x16\x61nalytics_account_link\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12J\n\x12\x61nalytics_property\x18\x02 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&analyticsadmin.googleapis.com/Property\x12Y\n\rservice_level\x18\x03 \x01(\x0e\x32=.google.marketingplatform.admin.v1alpha.AnalyticsServiceLevelB\x03\xe0\x41\x02\"!\n\x1fSetPropertyServiceLevelResponse*\x87\x01\n\x15\x41nalyticsServiceLevel\x12\'\n#ANALYTICS_SERVICE_LEVEL_UNSPECIFIED\x10\x00\x12$\n ANALYTICS_SERVICE_LEVEL_STANDARD\x10\x01\x12\x1f\n\x1b\x41NALYTICS_SERVICE_LEVEL_360\x10\x02\x32\xb2\x0b\n\x1dMarketingplatformAdminService\x12\xb7\x01\n\x0fGetOrganization\x12>.google.marketingplatform.admin.v1alpha.GetOrganizationRequest\x1a\x34.google.marketingplatform.admin.v1alpha.Organization\".\xda\x41\x04name\x82\xd3\xe4\x93\x02!\x12\x1f/v1alpha/{name=organizations/*}\x12\xfa\x01\n\x19ListAnalyticsAccountLinks\x12H.google.marketingplatform.admin.v1alpha.ListAnalyticsAccountLinksRequest\x1aI.google.marketingplatform.admin.v1alpha.ListAnalyticsAccountLinksResponse\"H\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x39\x12\x37/v1alpha/{parent=organizations/*}/analyticsAccountLinks\x12\x9e\x02\n\x1a\x43reateAnalyticsAccountLink\x12I.google.marketingplatform.admin.v1alpha.CreateAnalyticsAccountLinkRequest\x1a<.google.marketingplatform.admin.v1alpha.AnalyticsAccountLink\"w\xda\x41\x1dparent,analytics_account_link\x82\xd3\xe4\x93\x02Q\"7/v1alpha/{parent=organizations/*}/analyticsAccountLinks:\x16\x61nalytics_account_link\x12\xc7\x01\n\x1a\x44\x65leteAnalyticsAccountLink\x12I.google.marketingplatform.admin.v1alpha.DeleteAnalyticsAccountLinkRequest\x1a\x16.google.protobuf.Empty\"F\xda\x41\x04name\x82\xd3\xe4\x93\x02\x39*7/v1alpha/{name=organizations/*/analyticsAccountLinks/*}\x12\xb2\x02\n\x17SetPropertyServiceLevel\x12\x46.google.marketingplatform.admin.v1alpha.SetPropertyServiceLevelRequest\x1aG.google.marketingplatform.admin.v1alpha.SetPropertyServiceLevelResponse\"\x85\x01\xda\x41\x16\x61nalytics_account_link\x82\xd3\xe4\x93\x02\x66\"a/v1alpha/{analytics_account_link=organizations/*/analyticsAccountLinks/*}:setPropertyServiceLevel:\x01*\x1a\xb9\x01\xca\x41%marketingplatformadmin.googleapis.com\xd2\x41\x8d\x01https://www.googleapis.com/auth/marketingplatformadmin.analytics.read,https://www.googleapis.com/auth/marketingplatformadmin.analytics.updateB\xe9\x02\n.com.google.ads.marketingplatform.admin.v1alphaB\x1bMarketingplatformAdminProtoP\x01ZKgoogle.golang.org/genproto/googleapis/marketingplatform/admin/v1alpha;admin\xaa\x02*Google.Ads.MarketingPlatform.Admin.V1Alpha\xca\x02*Google\\Ads\\MarketingPlatform\\Admin\\V1alpha\xea\x02.Google::Ads::MarketingPlatform::Admin::V1alpha\xea\x41?\n&analyticsadmin.googleapis.com/Property\x12\x15properties/{property}b\x06proto3"
+descriptor_data = "\nDgoogle/marketingplatform/admin/v1alpha/marketingplatform_admin.proto\x12&google.marketingplatform.admin.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x36google/marketingplatform/admin/v1alpha/resources.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x16google/type/date.proto\x1a\x17google/type/money.proto\"b\n\x16GetOrganizationRequest\x12H\n\x04name\x18\x01 \x01(\tB:\xe0\x41\x02\xfa\x41\x34\n2marketingplatformadmin.googleapis.com/Organization\"K\n\x18ListOrganizationsRequest\x12\x16\n\tpage_size\x18\x01 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x02 \x01(\tB\x03\xe0\x41\x01\"\x81\x01\n\x19ListOrganizationsResponse\x12K\n\rorganizations\x18\x01 \x03(\x0b\x32\x34.google.marketingplatform.admin.v1alpha.Organization\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x91\x01\n%FindSalesPartnerManagedClientsRequest\x12P\n\x0corganization\x18\x01 \x01(\tB:\xe0\x41\x02\xfa\x41\x34\n2marketingplatformadmin.googleapis.com/Organization\x12\x16\n\tis_active\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01\"\xbf\x02\n&FindSalesPartnerManagedClientsResponse\x12n\n\x0b\x63lient_data\x18\x01 \x03(\x0b\x32Y.google.marketingplatform.admin.v1alpha.FindSalesPartnerManagedClientsResponse.ClientData\x1a\xa4\x01\n\nClientData\x12J\n\x0corganization\x18\x01 \x01(\x0b\x32\x34.google.marketingplatform.admin.v1alpha.Organization\x12%\n\nstart_date\x18\x02 \x01(\x0b\x32\x11.google.type.Date\x12#\n\x08\x65nd_date\x18\x03 \x01(\x0b\x32\x11.google.type.Date\"\xa7\x01\n ListAnalyticsAccountLinksRequest\x12R\n\x06parent\x18\x01 \x01(\tBB\xe0\x41\x02\xfa\x41<\x12:marketingplatformadmin.googleapis.com/AnalyticsAccountLink\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\"\x9b\x01\n!ListAnalyticsAccountLinksResponse\x12]\n\x17\x61nalytics_account_links\x18\x01 \x03(\x0b\x32<.google.marketingplatform.admin.v1alpha.AnalyticsAccountLink\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xda\x01\n!CreateAnalyticsAccountLinkRequest\x12R\n\x06parent\x18\x01 \x01(\tBB\xe0\x41\x02\xfa\x41<\x12:marketingplatformadmin.googleapis.com/AnalyticsAccountLink\x12\x61\n\x16\x61nalytics_account_link\x18\x02 \x01(\x0b\x32<.google.marketingplatform.admin.v1alpha.AnalyticsAccountLinkB\x03\xe0\x41\x02\"u\n!DeleteAnalyticsAccountLinkRequest\x12P\n\x04name\x18\x01 \x01(\tBB\xe0\x41\x02\xfa\x41<\n:marketingplatformadmin.googleapis.com/AnalyticsAccountLink\"\xec\x01\n\x1eSetPropertyServiceLevelRequest\x12#\n\x16\x61nalytics_account_link\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12J\n\x12\x61nalytics_property\x18\x02 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&analyticsadmin.googleapis.com/Property\x12Y\n\rservice_level\x18\x03 \x01(\x0e\x32=.google.marketingplatform.admin.v1alpha.AnalyticsServiceLevelB\x03\xe0\x41\x02\"!\n\x1fSetPropertyServiceLevelResponse\"K\n\x1aReportPropertyUsageRequest\x12\x19\n\x0corganization\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x12\n\x05month\x18\x02 \x01(\tB\x03\xe0\x41\x02\"\xcf\x05\n\x1bReportPropertyUsageResponse\x12j\n\x0fproperty_usages\x18\x01 \x03(\x0b\x32Q.google.marketingplatform.admin.v1alpha.ReportPropertyUsageResponse.PropertyUsage\x12_\n\tbill_info\x18\x02 \x01(\x0b\x32L.google.marketingplatform.admin.v1alpha.ReportPropertyUsageResponse.BillInfo\x1a\xb0\x02\n\rPropertyUsage\x12\x10\n\x08property\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x12\n\naccount_id\x18\x03 \x01(\x03\x12T\n\rservice_level\x18\x04 \x01(\x0e\x32=.google.marketingplatform.admin.v1alpha.AnalyticsServiceLevel\x12T\n\rproperty_type\x18\x05 \x01(\x0e\x32=.google.marketingplatform.admin.v1alpha.AnalyticsPropertyType\x12\x19\n\x11total_event_count\x18\x06 \x01(\x03\x12\x1c\n\x14\x62illable_event_count\x18\x07 \x01(\x03\x1a\xaf\x01\n\x08\x42illInfo\x12$\n\x08\x62\x61se_fee\x18\x01 \x01(\x0b\x32\x12.google.type.Money\x12%\n\tevent_fee\x18\x02 \x01(\x0b\x32\x12.google.type.Money\x12\x33\n\x17price_protection_credit\x18\x03 \x01(\x0b\x32\x12.google.type.Money\x12!\n\x05total\x18\x04 \x01(\x0b\x32\x12.google.type.Money2\xfa\x10\n\x1dMarketingplatformAdminService\x12\xb7\x01\n\x0fGetOrganization\x12>.google.marketingplatform.admin.v1alpha.GetOrganizationRequest\x1a\x34.google.marketingplatform.admin.v1alpha.Organization\".\xda\x41\x04name\x82\xd3\xe4\x93\x02!\x12\x1f/v1alpha/{name=organizations/*}\x12\xb8\x01\n\x11ListOrganizations\x12@.google.marketingplatform.admin.v1alpha.ListOrganizationsRequest\x1a\x41.google.marketingplatform.admin.v1alpha.ListOrganizationsResponse\"\x1e\x82\xd3\xe4\x93\x02\x18\x12\x16/v1alpha/organizations\x12\x92\x02\n\x1e\x46indSalesPartnerManagedClients\x12M.google.marketingplatform.admin.v1alpha.FindSalesPartnerManagedClientsRequest\x1aN.google.marketingplatform.admin.v1alpha.FindSalesPartnerManagedClientsResponse\"Q\x82\xd3\xe4\x93\x02K\"F/v1alpha/{organization=organizations/*}:findSalesPartnerManagedClients:\x01*\x12\xfa\x01\n\x19ListAnalyticsAccountLinks\x12H.google.marketingplatform.admin.v1alpha.ListAnalyticsAccountLinksRequest\x1aI.google.marketingplatform.admin.v1alpha.ListAnalyticsAccountLinksResponse\"H\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x39\x12\x37/v1alpha/{parent=organizations/*}/analyticsAccountLinks\x12\x9e\x02\n\x1a\x43reateAnalyticsAccountLink\x12I.google.marketingplatform.admin.v1alpha.CreateAnalyticsAccountLinkRequest\x1a<.google.marketingplatform.admin.v1alpha.AnalyticsAccountLink\"w\xda\x41\x1dparent,analytics_account_link\x82\xd3\xe4\x93\x02Q\"7/v1alpha/{parent=organizations/*}/analyticsAccountLinks:\x16\x61nalytics_account_link\x12\xc7\x01\n\x1a\x44\x65leteAnalyticsAccountLink\x12I.google.marketingplatform.admin.v1alpha.DeleteAnalyticsAccountLinkRequest\x1a\x16.google.protobuf.Empty\"F\xda\x41\x04name\x82\xd3\xe4\x93\x02\x39*7/v1alpha/{name=organizations/*/analyticsAccountLinks/*}\x12\xb2\x02\n\x17SetPropertyServiceLevel\x12\x46.google.marketingplatform.admin.v1alpha.SetPropertyServiceLevelRequest\x1aG.google.marketingplatform.admin.v1alpha.SetPropertyServiceLevelResponse\"\x85\x01\xda\x41\x16\x61nalytics_account_link\x82\xd3\xe4\x93\x02\x66\"a/v1alpha/{analytics_account_link=organizations/*/analyticsAccountLinks/*}:setPropertyServiceLevel:\x01*\x12\xf5\x01\n\x13ReportPropertyUsage\x12\x42.google.marketingplatform.admin.v1alpha.ReportPropertyUsageRequest\x1a\x43.google.marketingplatform.admin.v1alpha.ReportPropertyUsageResponse\"U\xda\x41\x0corganization\x82\xd3\xe4\x93\x02@\";/v1alpha/{organization=organizations/*}:reportPropertyUsage:\x01*\x1a\xb9\x01\xca\x41%marketingplatformadmin.googleapis.com\xd2\x41\x8d\x01https://www.googleapis.com/auth/marketingplatformadmin.analytics.read,https://www.googleapis.com/auth/marketingplatformadmin.analytics.updateB\xe9\x02\n.com.google.ads.marketingplatform.admin.v1alphaB\x1bMarketingplatformAdminProtoP\x01ZKgoogle.golang.org/genproto/googleapis/marketingplatform/admin/v1alpha;admin\xaa\x02*Google.Ads.MarketingPlatform.Admin.V1Alpha\xca\x02*Google\\Ads\\MarketingPlatform\\Admin\\V1alpha\xea\x02.Google::Ads::MarketingPlatform::Admin::V1alpha\xea\x41?\n&analyticsadmin.googleapis.com/Property\x12\x15properties/{property}b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 
@@ -27,7 +29,9 @@ rescue TypeError
   file = pool.add_serialized_file(serialized)
   warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
   imports = [
-    ["google.marketingplatform.admin.v1alpha.AnalyticsAccountLink", "google/marketingplatform/admin/v1alpha/resources.proto"],
+    ["google.marketingplatform.admin.v1alpha.Organization", "google/marketingplatform/admin/v1alpha/resources.proto"],
+    ["google.type.Date", "google/type/date.proto"],
+    ["google.type.Money", "google/type/money.proto"],
   ]
   imports.each do |type_name, expected_filename|
     import_file = pool.lookup(type_name).file_descriptor
@@ -45,13 +49,21 @@ module Google
       module Admin
         module V1alpha
           GetOrganizationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.GetOrganizationRequest").msgclass
+          ListOrganizationsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ListOrganizationsRequest").msgclass
+          ListOrganizationsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ListOrganizationsResponse").msgclass
+          FindSalesPartnerManagedClientsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.FindSalesPartnerManagedClientsRequest").msgclass
+          FindSalesPartnerManagedClientsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.FindSalesPartnerManagedClientsResponse").msgclass
+          FindSalesPartnerManagedClientsResponse::ClientData = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.FindSalesPartnerManagedClientsResponse.ClientData").msgclass
           ListAnalyticsAccountLinksRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ListAnalyticsAccountLinksRequest").msgclass
           ListAnalyticsAccountLinksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ListAnalyticsAccountLinksResponse").msgclass
           CreateAnalyticsAccountLinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.CreateAnalyticsAccountLinkRequest").msgclass
           DeleteAnalyticsAccountLinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.DeleteAnalyticsAccountLinkRequest").msgclass
           SetPropertyServiceLevelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.SetPropertyServiceLevelRequest").msgclass
           SetPropertyServiceLevelResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.SetPropertyServiceLevelResponse").msgclass
-          AnalyticsServiceLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.AnalyticsServiceLevel").enummodule
+          ReportPropertyUsageRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ReportPropertyUsageRequest").msgclass
+          ReportPropertyUsageResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ReportPropertyUsageResponse").msgclass
+          ReportPropertyUsageResponse::PropertyUsage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ReportPropertyUsageResponse.PropertyUsage").msgclass
+          ReportPropertyUsageResponse::BillInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.marketingplatform.admin.v1alpha.ReportPropertyUsageResponse.BillInfo").msgclass
         end
       end
     end