google-apis-searchads360_v0 0.17.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4189a733ea7e77d02949f502a5794aacf064777aeecd5c0914fbee3b9f143ff
-  data.tar.gz: f5789fdfc5fc11ddbd15925f31cbc1f6c5e16fe1390e21cdb187a4b748daa95f
+  metadata.gz: 4ebc31b008300f4ae35bea84447e02ccdd03bac4fdd427713037d1ac41d2c01a
+  data.tar.gz: 3008ccb8261cc675a090a83a61d3f8883c4d146c1678a78db1aac4f49d07daca
 SHA512:
-  metadata.gz: c6a49fd08563b38782ead74f2e123441a8580f7a1eb4ec13d4942875d3a293c7098d26351d43b4dfd08245602eb2d45ab7439d083e854c1e45b083ff47953544
-  data.tar.gz: 1c89b9521826f7829c165c110172aaec6a5b954d961e521d3dde1e68f4a2d22a21a01c4eb1f3335043189aede9082b769588b1318a62a3bbdd7ec4498712904e
+  metadata.gz: 6adea95a64d4af82934bdae049da830ee85aa8073a0feff144fe9982cf5d8f1be090c5d2d85d3bee7d353d74a04819ca5c492aaa1e98f210699c1ed538c1c7cd
+  data.tar.gz: a103fb2c0617bb05a71ba7a20f0387e8682d74b650967e421824f838ddcedc5439ba2f50f314fe3f25c3d38db252ab0123e70df7141e70658a920b26afd47096

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-searchads360_v0
 
+### v0.19.0 (2024-11-17)
+
+* Regenerated from discovery document revision 20241108
+
+### v0.18.0 (2024-10-06)
+
+* Regenerated from discovery document revision 20241002
+
 ### v0.17.0 (2024-08-25)
 
 * Regenerated from discovery document revision 20240822

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

@@ -1084,11 +1084,25 @@ module Google
         # @return [Float]
         attr_accessor :cross_device_conversions
       
+        # The number of cross-device conversions by conversion date. Details for the
+        # by_conversion_date columns are available at https://support.google.com/sa360/
+        # answer/9250611.
+        # Corresponds to the JSON property `crossDeviceConversionsByConversionDate`
+        # @return [Float]
+        attr_accessor :cross_device_conversions_by_conversion_date
+      
         # The sum of the value of cross-device conversions.
         # Corresponds to the JSON property `crossDeviceConversionsValue`
         # @return [Float]
         attr_accessor :cross_device_conversions_value
       
+        # The sum of cross-device conversions value by conversion date. Details for the
+        # by_conversion_date columns are available at https://support.google.com/sa360/
+        # answer/9250611.
+        # Corresponds to the JSON property `crossDeviceConversionsValueByConversionDate`
+        # @return [Float]
+        attr_accessor :cross_device_conversions_value_by_conversion_date
+      
         # Cross-sell cost of goods sold (COGS) is the total cost of products sold as a
         # result of advertising a different product. How it works: You report
         # conversions with cart data for completed purchases on your website. If the ad
@@ -1167,6 +1181,27 @@ module Google
         # @return [Float]
         attr_accessor :ctr
       
+        # The percentage of clicks that have been filtered out of your total number of
+        # clicks (filtered + non-filtered clicks) due to being general invalid clicks.
+        # These are clicks Google considers illegitimate that are detected through
+        # routine means of filtration (that is, known invalid data-center traffic, bots
+        # and spiders or other crawlers, irregular patterns, etc). You're not charged
+        # for them, and they don't affect your account statistics. See the help page at
+        # https://support.google.com/campaignmanager/answer/6076504 for details.
+        # Corresponds to the JSON property `generalInvalidClickRate`
+        # @return [Float]
+        attr_accessor :general_invalid_click_rate
+      
+        # Number of general invalid clicks. These are a subset of your invalid clicks
+        # that are detected through routine means of filtration (such as known invalid
+        # data-center traffic, bots and spiders or other crawlers, irregular patterns,
+        # etc.). You're not charged for them, and they don't affect your account
+        # statistics. See the help page at https://support.google.com/campaignmanager/
+        # answer/6076504 for details.
+        # Corresponds to the JSON property `generalInvalidClicks`
+        # @return [Fixnum]
+        attr_accessor :general_invalid_clicks
+      
         # The creative historical quality score.
         # Corresponds to the JSON property `historicalCreativeQualityScore`
         # @return [String]
@@ -1483,12 +1518,16 @@ module Google
           @cost_per_conversion = args[:cost_per_conversion] if args.key?(:cost_per_conversion)
           @cost_per_current_model_attributed_conversion = args[:cost_per_current_model_attributed_conversion] if args.key?(:cost_per_current_model_attributed_conversion)
           @cross_device_conversions = args[:cross_device_conversions] if args.key?(:cross_device_conversions)
+          @cross_device_conversions_by_conversion_date = args[:cross_device_conversions_by_conversion_date] if args.key?(:cross_device_conversions_by_conversion_date)
           @cross_device_conversions_value = args[:cross_device_conversions_value] if args.key?(:cross_device_conversions_value)
+          @cross_device_conversions_value_by_conversion_date = args[:cross_device_conversions_value_by_conversion_date] if args.key?(:cross_device_conversions_value_by_conversion_date)
           @cross_sell_cost_of_goods_sold_micros = args[:cross_sell_cost_of_goods_sold_micros] if args.key?(:cross_sell_cost_of_goods_sold_micros)
           @cross_sell_gross_profit_micros = args[:cross_sell_gross_profit_micros] if args.key?(:cross_sell_gross_profit_micros)
           @cross_sell_revenue_micros = args[:cross_sell_revenue_micros] if args.key?(:cross_sell_revenue_micros)
           @cross_sell_units_sold = args[:cross_sell_units_sold] if args.key?(:cross_sell_units_sold)
           @ctr = args[:ctr] if args.key?(:ctr)
+          @general_invalid_click_rate = args[:general_invalid_click_rate] if args.key?(:general_invalid_click_rate)
+          @general_invalid_clicks = args[:general_invalid_clicks] if args.key?(:general_invalid_clicks)
           @historical_creative_quality_score = args[:historical_creative_quality_score] if args.key?(:historical_creative_quality_score)
           @historical_landing_page_quality_score = args[:historical_landing_page_quality_score] if args.key?(:historical_landing_page_quality_score)
           @historical_quality_score = args[:historical_quality_score] if args.key?(:historical_quality_score)
@@ -3506,7 +3545,8 @@ module Google
       class GoogleAdsSearchads360V0ResourcesCampaignSelectiveOptimization
         include Google::Apis::Core::Hashable
       
-        # The selected set of conversion actions for optimizing this campaign.
+        # The selected set of resource names for conversion actions for optimizing this
+        # campaign.
         # Corresponds to the JSON property `conversionActions`
         # @return [Array<String>]
         attr_accessor :conversion_actions
@@ -4081,6 +4121,12 @@ module Google
         # @return [String]
         attr_accessor :creation_time
       
+        # Output only. The resource names of effective labels attached to this ad group.
+        # An effective label is a label inherited or directly assigned to this ad group.
+        # Corresponds to the JSON property `effectiveLabels`
+        # @return [Array<String>]
+        attr_accessor :effective_labels
+      
         # Output only. Date when the ad group ends serving ads. By default, the ad group
         # ends on the ad group's end date. If this field is set, then the ad group ends
         # at the end of the specified date in the customer's time zone. This field is
@@ -4176,6 +4222,7 @@ module Google
           @ad_rotation_mode = args[:ad_rotation_mode] if args.key?(:ad_rotation_mode)
           @cpc_bid_micros = args[:cpc_bid_micros] if args.key?(:cpc_bid_micros)
           @creation_time = args[:creation_time] if args.key?(:creation_time)
+          @effective_labels = args[:effective_labels] if args.key?(:effective_labels)
           @end_date = args[:end_date] if args.key?(:end_date)
           @engine_id = args[:engine_id] if args.key?(:engine_id)
           @engine_status = args[:engine_status] if args.key?(:engine_status)
@@ -4207,6 +4254,12 @@ module Google
         # @return [String]
         attr_accessor :creation_time
       
+        # Output only. The resource names of effective labels attached to this ad. An
+        # effective label is a label inherited or directly assigned to this ad.
+        # Corresponds to the JSON property `effectiveLabels`
+        # @return [Array<String>]
+        attr_accessor :effective_labels
+      
         # Output only. ID of the ad in the external engine account. This field is for
         # Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc.
         # For non-Search Ads 360 entity, use "ad_group_ad.ad.id" instead.
@@ -4252,6 +4305,7 @@ module Google
         def update!(**args)
           @ad = args[:ad] if args.key?(:ad)
           @creation_time = args[:creation_time] if args.key?(:creation_time)
+          @effective_labels = args[:effective_labels] if args.key?(:effective_labels)
           @engine_id = args[:engine_id] if args.key?(:engine_id)
           @engine_status = args[:engine_status] if args.key?(:engine_status)
           @labels = args[:labels] if args.key?(:labels)
@@ -4261,6 +4315,46 @@ module Google
         end
       end
       
+      # A relationship between an ad group ad and an effective label. An effective
+      # label is a label inherited or directly assigned to this ad group ad.
+      class GoogleAdsSearchads360V0ResourcesAdGroupAdEffectiveLabel
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. The ad group ad to which the effective label is attached.
+        # Corresponds to the JSON property `adGroupAd`
+        # @return [String]
+        attr_accessor :ad_group_ad
+      
+        # Immutable. The effective label assigned to the ad group ad.
+        # Corresponds to the JSON property `label`
+        # @return [String]
+        attr_accessor :label
+      
+        # Output only. The ID of the Customer which owns the effective label.
+        # Corresponds to the JSON property `ownerCustomerId`
+        # @return [Fixnum]
+        attr_accessor :owner_customer_id
+      
+        # Immutable. The resource name of the ad group ad effective label. Ad group ad
+        # effective label resource names have the form: `customers/`customer_id`/
+        # adGroupAdEffectiveLabels/`ad_group_id`~`ad_id`~`label_id``
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ad_group_ad = args[:ad_group_ad] if args.key?(:ad_group_ad)
+          @label = args[:label] if args.key?(:label)
+          @owner_customer_id = args[:owner_customer_id] if args.key?(:owner_customer_id)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+        end
+      end
+      
       # A relationship between an ad group ad and a label.
       class GoogleAdsSearchads360V0ResourcesAdGroupAdLabel
         include Google::Apis::Core::Hashable
@@ -4479,6 +4573,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :effective_cpc_bid_micros
       
+        # Output only. The resource names of effective labels attached to this ad group
+        # criterion. An effective label is a label inherited or directly assigned to
+        # this ad group criterion.
+        # Corresponds to the JSON property `effectiveLabels`
+        # @return [Array<String>]
+        attr_accessor :effective_labels
+      
         # Output only. ID of the ad group criterion in the external engine account. This
         # field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft,
         # Baidu etc. For Google Ads entity, use "ad_group_criterion.criterion_id"
@@ -4605,6 +4706,7 @@ module Google
           @creation_time = args[:creation_time] if args.key?(:creation_time)
           @criterion_id = args[:criterion_id] if args.key?(:criterion_id)
           @effective_cpc_bid_micros = args[:effective_cpc_bid_micros] if args.key?(:effective_cpc_bid_micros)
+          @effective_labels = args[:effective_labels] if args.key?(:effective_labels)
           @engine_id = args[:engine_id] if args.key?(:engine_id)
           @engine_status = args[:engine_status] if args.key?(:engine_status)
           @final_url_suffix = args[:final_url_suffix] if args.key?(:final_url_suffix)
@@ -4627,6 +4729,48 @@ module Google
         end
       end
       
+      # A relationship between an ad group criterion and an effective label. An
+      # effective label is a label inherited or directly assigned to this ad group
+      # criterion.
+      class GoogleAdsSearchads360V0ResourcesAdGroupCriterionEffectiveLabel
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. The ad group criterion to which the effective label is attached.
+        # Corresponds to the JSON property `adGroupCriterion`
+        # @return [String]
+        attr_accessor :ad_group_criterion
+      
+        # Immutable. The effective label assigned to the ad group criterion.
+        # Corresponds to the JSON property `label`
+        # @return [String]
+        attr_accessor :label
+      
+        # Output only. The ID of the Customer which owns the effective label.
+        # Corresponds to the JSON property `ownerCustomerId`
+        # @return [Fixnum]
+        attr_accessor :owner_customer_id
+      
+        # Immutable. The resource name of the ad group criterion effective label. Ad
+        # group criterion effective label resource names have the form: `customers/`
+        # customer_id`/adGroupCriterionEffectiveLabels/`ad_group_id`~`criterion_id`~`
+        # label_id``
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ad_group_criterion = args[:ad_group_criterion] if args.key?(:ad_group_criterion)
+          @label = args[:label] if args.key?(:label)
+          @owner_customer_id = args[:owner_customer_id] if args.key?(:owner_customer_id)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+        end
+      end
+      
       # A relationship between an ad group criterion and a label.
       class GoogleAdsSearchads360V0ResourcesAdGroupCriterionLabel
         include Google::Apis::Core::Hashable
@@ -4666,6 +4810,46 @@ module Google
         end
       end
       
+      # A relationship between an ad group and an effective label. An effective label
+      # is a label inherited or directly assigned to this ad group.
+      class GoogleAdsSearchads360V0ResourcesAdGroupEffectiveLabel
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. The ad group to which the effective label is attached.
+        # Corresponds to the JSON property `adGroup`
+        # @return [String]
+        attr_accessor :ad_group
+      
+        # Immutable. The effective label assigned to the ad group.
+        # Corresponds to the JSON property `label`
+        # @return [String]
+        attr_accessor :label
+      
+        # Output only. The ID of the Customer which owns the effective label.
+        # Corresponds to the JSON property `ownerCustomerId`
+        # @return [Fixnum]
+        attr_accessor :owner_customer_id
+      
+        # Immutable. The resource name of the ad group effective label. Ad group
+        # effective label resource names have the form: `customers/`customer_id`/
+        # adGroupEffectiveLabels/`ad_group_id`~`label_id``
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ad_group = args[:ad_group] if args.key?(:ad_group)
+          @label = args[:label] if args.key?(:label)
+          @owner_customer_id = args[:owner_customer_id] if args.key?(:owner_customer_id)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+        end
+      end
+      
       # A relationship between an ad group and a label.
       class GoogleAdsSearchads360V0ResourcesAdGroupLabel
         include Google::Apis::Core::Hashable
@@ -5430,7 +5614,7 @@ module Google
         # @return [String]
         attr_accessor :advertising_channel_type
       
-        # Portfolio bidding strategy used by campaign.
+        # The resource name of the portfolio bidding strategy used by the campaign.
         # Corresponds to the JSON property `biddingStrategy`
         # @return [String]
         attr_accessor :bidding_strategy
@@ -5448,7 +5632,7 @@ module Google
         # @return [String]
         attr_accessor :bidding_strategy_type
       
-        # The budget of the campaign.
+        # The resource name of the campaign budget of the campaign.
         # Corresponds to the JSON property `campaignBudget`
         # @return [String]
         attr_accessor :campaign_budget
@@ -5471,6 +5655,12 @@ module Google
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignDynamicSearchAdsSetting]
         attr_accessor :dynamic_search_ads_setting
       
+        # Output only. The resource names of effective labels attached to this campaign.
+        # An effective label is a label inherited or directly assigned to this campaign.
+        # Corresponds to the JSON property `effectiveLabels`
+        # @return [Array<String>]
+        attr_accessor :effective_labels
+      
         # The last day of the campaign in serving customer's timezone in YYYY-MM-DD
         # format. On create, defaults to 2037-12-30, which means the campaign will run
         # indefinitely. To set an existing campaign to run indefinitely, set this field
@@ -5694,6 +5884,7 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @creation_time = args[:creation_time] if args.key?(:creation_time)
           @dynamic_search_ads_setting = args[:dynamic_search_ads_setting] if args.key?(:dynamic_search_ads_setting)
+          @effective_labels = args[:effective_labels] if args.key?(:effective_labels)
           @end_date = args[:end_date] if args.key?(:end_date)
           @engine_id = args[:engine_id] if args.key?(:engine_id)
           @excluded_parent_asset_field_types = args[:excluded_parent_asset_field_types] if args.key?(:excluded_parent_asset_field_types)
@@ -6001,6 +6192,46 @@ module Google
         end
       end
       
+      # Represents a relationship between a campaign and an effective label. An
+      # effective label is a label inherited or directly assigned to this campaign.
+      class GoogleAdsSearchads360V0ResourcesCampaignEffectiveLabel
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. The campaign to which the effective label is attached.
+        # Corresponds to the JSON property `campaign`
+        # @return [String]
+        attr_accessor :campaign
+      
+        # Immutable. The effective label assigned to the campaign.
+        # Corresponds to the JSON property `label`
+        # @return [String]
+        attr_accessor :label
+      
+        # Output only. The ID of the Customer which owns the effective label.
+        # Corresponds to the JSON property `ownerCustomerId`
+        # @return [Fixnum]
+        attr_accessor :owner_customer_id
+      
+        # Immutable. Name of the resource. CampaignEffectivelabel resource names have
+        # the form: `customers/`customer_id`/campaignEffectiveLabels/`campaign_id`~`
+        # label_id``
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @campaign = args[:campaign] if args.key?(:campaign)
+          @label = args[:label] if args.key?(:label)
+          @owner_customer_id = args[:owner_customer_id] if args.key?(:owner_customer_id)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+        end
+      end
+      
       # Represents a relationship between a campaign and a label.
       class GoogleAdsSearchads360V0ResourcesCampaignLabel
         include Google::Apis::Core::Hashable
@@ -7578,6 +7809,43 @@ module Google
         end
       end
       
+      # A user location view. User Location View includes all metrics aggregated at
+      # the country level, one row per country. It reports metrics at the actual
+      # physical location of the user by targeted or not targeted location. If other
+      # segment fields are used, you may get more than one row per country.
+      class GoogleAdsSearchads360V0ResourcesUserLocationView
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Criterion Id for the country.
+        # Corresponds to the JSON property `countryCriterionId`
+        # @return [Fixnum]
+        attr_accessor :country_criterion_id
+      
+        # Output only. The resource name of the user location view. UserLocation view
+        # resource names have the form: `customers/`customer_id`/userLocationViews/`
+        # country_criterion_id`~`targeting_location``
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        # Output only. Indicates whether location was targeted or not.
+        # Corresponds to the JSON property `targetingLocation`
+        # @return [Boolean]
+        attr_accessor :targeting_location
+        alias_method :targeting_location?, :targeting_location
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @country_criterion_id = args[:country_criterion_id] if args.key?(:country_criterion_id)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+          @targeting_location = args[:targeting_location] if args.key?(:targeting_location)
+        end
+      end
+      
       # A visit.
       class GoogleAdsSearchads360V0ResourcesVisit
         include Google::Apis::Core::Hashable
@@ -7901,6 +8169,12 @@ module Google
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAd]
         attr_accessor :ad_group_ad
       
+        # A relationship between an ad group ad and an effective label. An effective
+        # label is a label inherited or directly assigned to this ad group ad.
+        # Corresponds to the JSON property `adGroupAdEffectiveLabel`
+        # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAdEffectiveLabel]
+        attr_accessor :ad_group_ad_effective_label
+      
         # A relationship between an ad group ad and a label.
         # Corresponds to the JSON property `adGroupAdLabel`
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAdLabel]
@@ -7935,11 +8209,24 @@ module Google
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterion]
         attr_accessor :ad_group_criterion
       
+        # A relationship between an ad group criterion and an effective label. An
+        # effective label is a label inherited or directly assigned to this ad group
+        # criterion.
+        # Corresponds to the JSON property `adGroupCriterionEffectiveLabel`
+        # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterionEffectiveLabel]
+        attr_accessor :ad_group_criterion_effective_label
+      
         # A relationship between an ad group criterion and a label.
         # Corresponds to the JSON property `adGroupCriterionLabel`
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterionLabel]
         attr_accessor :ad_group_criterion_label
       
+        # A relationship between an ad group and an effective label. An effective label
+        # is a label inherited or directly assigned to this ad group.
+        # Corresponds to the JSON property `adGroupEffectiveLabel`
+        # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupEffectiveLabel]
+        attr_accessor :ad_group_effective_label
+      
         # A relationship between an ad group and a label.
         # Corresponds to the JSON property `adGroupLabel`
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupLabel]
@@ -8047,6 +8334,12 @@ module Google
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignCriterion]
         attr_accessor :campaign_criterion
       
+        # Represents a relationship between a campaign and an effective label. An
+        # effective label is a label inherited or directly assigned to this campaign.
+        # Corresponds to the JSON property `campaignEffectiveLabel`
+        # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignEffectiveLabel]
+        attr_accessor :campaign_effective_label
+      
         # Represents a relationship between a campaign and a label.
         # Corresponds to the JSON property `campaignLabel`
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignLabel]
@@ -8179,6 +8472,14 @@ module Google
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesUserList]
         attr_accessor :user_list
       
+        # A user location view. User Location View includes all metrics aggregated at
+        # the country level, one row per country. It reports metrics at the actual
+        # physical location of the user by targeted or not targeted location. If other
+        # segment fields are used, you may get more than one row per country.
+        # Corresponds to the JSON property `userLocationView`
+        # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesUserLocationView]
+        attr_accessor :user_location_view
+      
         # A visit.
         # Corresponds to the JSON property `visit`
         # @return [Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesVisit]
@@ -8198,13 +8499,16 @@ module Google
           @accessible_bidding_strategy = args[:accessible_bidding_strategy] if args.key?(:accessible_bidding_strategy)
           @ad_group = args[:ad_group] if args.key?(:ad_group)
           @ad_group_ad = args[:ad_group_ad] if args.key?(:ad_group_ad)
+          @ad_group_ad_effective_label = args[:ad_group_ad_effective_label] if args.key?(:ad_group_ad_effective_label)
           @ad_group_ad_label = args[:ad_group_ad_label] if args.key?(:ad_group_ad_label)
           @ad_group_asset = args[:ad_group_asset] if args.key?(:ad_group_asset)
           @ad_group_asset_set = args[:ad_group_asset_set] if args.key?(:ad_group_asset_set)
           @ad_group_audience_view = args[:ad_group_audience_view] if args.key?(:ad_group_audience_view)
           @ad_group_bid_modifier = args[:ad_group_bid_modifier] if args.key?(:ad_group_bid_modifier)
           @ad_group_criterion = args[:ad_group_criterion] if args.key?(:ad_group_criterion)
+          @ad_group_criterion_effective_label = args[:ad_group_criterion_effective_label] if args.key?(:ad_group_criterion_effective_label)
           @ad_group_criterion_label = args[:ad_group_criterion_label] if args.key?(:ad_group_criterion_label)
+          @ad_group_effective_label = args[:ad_group_effective_label] if args.key?(:ad_group_effective_label)
           @ad_group_label = args[:ad_group_label] if args.key?(:ad_group_label)
           @age_range_view = args[:age_range_view] if args.key?(:age_range_view)
           @asset = args[:asset] if args.key?(:asset)
@@ -8223,6 +8527,7 @@ module Google
           @campaign_audience_view = args[:campaign_audience_view] if args.key?(:campaign_audience_view)
           @campaign_budget = args[:campaign_budget] if args.key?(:campaign_budget)
           @campaign_criterion = args[:campaign_criterion] if args.key?(:campaign_criterion)
+          @campaign_effective_label = args[:campaign_effective_label] if args.key?(:campaign_effective_label)
           @campaign_label = args[:campaign_label] if args.key?(:campaign_label)
           @cart_data_sales_view = args[:cart_data_sales_view] if args.key?(:cart_data_sales_view)
           @conversion = args[:conversion] if args.key?(:conversion)
@@ -8247,6 +8552,7 @@ module Google
           @segments = args[:segments] if args.key?(:segments)
           @shopping_performance_view = args[:shopping_performance_view] if args.key?(:shopping_performance_view)
           @user_list = args[:user_list] if args.key?(:user_list)
+          @user_location_view = args[:user_location_view] if args.key?(:user_location_view)
           @visit = args[:visit] if args.key?(:visit)
           @webpage_view = args[:webpage_view] if args.key?(:webpage_view)
         end

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module Searchads360V0
       # Version of the google-apis-searchads360_v0 gem
-      GEM_VERSION = "0.17.0"
+      GEM_VERSION = "0.19.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240822"
+      REVISION = "20241108"
     end
   end
 end

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

@@ -580,6 +580,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleAdsSearchads360V0ResourcesAdGroupAdEffectiveLabel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleAdsSearchads360V0ResourcesAdGroupAdLabel
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -616,12 +622,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleAdsSearchads360V0ResourcesAdGroupCriterionEffectiveLabel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleAdsSearchads360V0ResourcesAdGroupCriterionLabel
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleAdsSearchads360V0ResourcesAdGroupEffectiveLabel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleAdsSearchads360V0ResourcesAdGroupLabel
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -736,6 +754,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleAdsSearchads360V0ResourcesCampaignEffectiveLabel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleAdsSearchads360V0ResourcesCampaignLabel
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -898,6 +922,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleAdsSearchads360V0ResourcesUserLocationView
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleAdsSearchads360V0ResourcesVisit
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1235,12 +1265,16 @@ module Google
           property :cost_per_conversion, as: 'costPerConversion'
           property :cost_per_current_model_attributed_conversion, as: 'costPerCurrentModelAttributedConversion'
           property :cross_device_conversions, as: 'crossDeviceConversions'
+          property :cross_device_conversions_by_conversion_date, as: 'crossDeviceConversionsByConversionDate'
           property :cross_device_conversions_value, as: 'crossDeviceConversionsValue'
+          property :cross_device_conversions_value_by_conversion_date, as: 'crossDeviceConversionsValueByConversionDate'
           property :cross_sell_cost_of_goods_sold_micros, :numeric_string => true, as: 'crossSellCostOfGoodsSoldMicros'
           property :cross_sell_gross_profit_micros, :numeric_string => true, as: 'crossSellGrossProfitMicros'
           property :cross_sell_revenue_micros, :numeric_string => true, as: 'crossSellRevenueMicros'
           property :cross_sell_units_sold, as: 'crossSellUnitsSold'
           property :ctr, as: 'ctr'
+          property :general_invalid_click_rate, as: 'generalInvalidClickRate'
+          property :general_invalid_clicks, :numeric_string => true, as: 'generalInvalidClicks'
           property :historical_creative_quality_score, as: 'historicalCreativeQualityScore'
           property :historical_landing_page_quality_score, as: 'historicalLandingPageQualityScore'
           property :historical_quality_score, :numeric_string => true, as: 'historicalQualityScore'
@@ -1950,6 +1984,7 @@ module Google
           property :ad_rotation_mode, as: 'adRotationMode'
           property :cpc_bid_micros, :numeric_string => true, as: 'cpcBidMicros'
           property :creation_time, as: 'creationTime'
+          collection :effective_labels, as: 'effectiveLabels'
           property :end_date, as: 'endDate'
           property :engine_id, as: 'engineId'
           property :engine_status, as: 'engineStatus'
@@ -1973,6 +2008,7 @@ module Google
           property :ad, as: 'ad', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAd, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAd::Representation
       
           property :creation_time, as: 'creationTime'
+          collection :effective_labels, as: 'effectiveLabels'
           property :engine_id, as: 'engineId'
           property :engine_status, as: 'engineStatus'
           collection :labels, as: 'labels'
@@ -1982,6 +2018,16 @@ module Google
         end
       end
       
+      class GoogleAdsSearchads360V0ResourcesAdGroupAdEffectiveLabel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ad_group_ad, as: 'adGroupAd'
+          property :label, as: 'label'
+          property :owner_customer_id, :numeric_string => true, as: 'ownerCustomerId'
+          property :resource_name, as: 'resourceName'
+        end
+      end
+      
       class GoogleAdsSearchads360V0ResourcesAdGroupAdLabel
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2040,6 +2086,7 @@ module Google
           property :creation_time, as: 'creationTime'
           property :criterion_id, :numeric_string => true, as: 'criterionId'
           property :effective_cpc_bid_micros, :numeric_string => true, as: 'effectiveCpcBidMicros'
+          collection :effective_labels, as: 'effectiveLabels'
           property :engine_id, as: 'engineId'
           property :engine_status, as: 'engineStatus'
           property :final_url_suffix, as: 'finalUrlSuffix'
@@ -2070,6 +2117,16 @@ module Google
         end
       end
       
+      class GoogleAdsSearchads360V0ResourcesAdGroupCriterionEffectiveLabel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ad_group_criterion, as: 'adGroupCriterion'
+          property :label, as: 'label'
+          property :owner_customer_id, :numeric_string => true, as: 'ownerCustomerId'
+          property :resource_name, as: 'resourceName'
+        end
+      end
+      
       class GoogleAdsSearchads360V0ResourcesAdGroupCriterionLabel
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2080,6 +2137,16 @@ module Google
         end
       end
       
+      class GoogleAdsSearchads360V0ResourcesAdGroupEffectiveLabel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ad_group, as: 'adGroup'
+          property :label, as: 'label'
+          property :owner_customer_id, :numeric_string => true, as: 'ownerCustomerId'
+          property :resource_name, as: 'resourceName'
+        end
+      end
+      
       class GoogleAdsSearchads360V0ResourcesAdGroupLabel
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2277,6 +2344,7 @@ module Google
           property :creation_time, as: 'creationTime'
           property :dynamic_search_ads_setting, as: 'dynamicSearchAdsSetting', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignDynamicSearchAdsSetting, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignDynamicSearchAdsSetting::Representation
       
+          collection :effective_labels, as: 'effectiveLabels'
           property :end_date, as: 'endDate'
           property :engine_id, as: 'engineId'
           collection :excluded_parent_asset_field_types, as: 'excludedParentAssetFieldTypes'
@@ -2403,6 +2471,16 @@ module Google
         end
       end
       
+      class GoogleAdsSearchads360V0ResourcesCampaignEffectiveLabel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :campaign, as: 'campaign'
+          property :label, as: 'label'
+          property :owner_customer_id, :numeric_string => true, as: 'ownerCustomerId'
+          property :resource_name, as: 'resourceName'
+        end
+      end
+      
       class GoogleAdsSearchads360V0ResourcesCampaignLabel
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2755,6 +2833,15 @@ module Google
         end
       end
       
+      class GoogleAdsSearchads360V0ResourcesUserLocationView
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :country_criterion_id, :numeric_string => true, as: 'countryCriterionId'
+          property :resource_name, as: 'resourceName'
+          property :targeting_location, as: 'targetingLocation'
+        end
+      end
+      
       class GoogleAdsSearchads360V0ResourcesVisit
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2847,6 +2934,8 @@ module Google
       
           property :ad_group_ad, as: 'adGroupAd', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAd, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAd::Representation
       
+          property :ad_group_ad_effective_label, as: 'adGroupAdEffectiveLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAdEffectiveLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAdEffectiveLabel::Representation
+      
           property :ad_group_ad_label, as: 'adGroupAdLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAdLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAdLabel::Representation
       
           property :ad_group_asset, as: 'adGroupAsset', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAsset, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupAsset::Representation
@@ -2859,8 +2948,12 @@ module Google
       
           property :ad_group_criterion, as: 'adGroupCriterion', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterion, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterion::Representation
       
+          property :ad_group_criterion_effective_label, as: 'adGroupCriterionEffectiveLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterionEffectiveLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterionEffectiveLabel::Representation
+      
           property :ad_group_criterion_label, as: 'adGroupCriterionLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterionLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupCriterionLabel::Representation
       
+          property :ad_group_effective_label, as: 'adGroupEffectiveLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupEffectiveLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupEffectiveLabel::Representation
+      
           property :ad_group_label, as: 'adGroupLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAdGroupLabel::Representation
       
           property :age_range_view, as: 'ageRangeView', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAgeRangeView, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesAgeRangeView::Representation
@@ -2897,6 +2990,8 @@ module Google
       
           property :campaign_criterion, as: 'campaignCriterion', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignCriterion, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignCriterion::Representation
       
+          property :campaign_effective_label, as: 'campaignEffectiveLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignEffectiveLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignEffectiveLabel::Representation
+      
           property :campaign_label, as: 'campaignLabel', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignLabel, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCampaignLabel::Representation
       
           property :cart_data_sales_view, as: 'cartDataSalesView', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCartDataSalesView, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesCartDataSalesView::Representation
@@ -2945,6 +3040,8 @@ module Google
       
           property :user_list, as: 'userList', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesUserList, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesUserList::Representation
       
+          property :user_location_view, as: 'userLocationView', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesUserLocationView, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesUserLocationView::Representation
+      
           property :visit, as: 'visit', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesVisit, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesVisit::Representation
       
           property :webpage_view, as: 'webpageView', class: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesWebpageView, decorator: Google::Apis::Searchads360V0::GoogleAdsSearchads360V0ResourcesWebpageView::Representation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-searchads360_v0
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-25 00:00:00.000000000 Z
+date: 2024-12-04 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-searchads360_v0/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-searchads360_v0/v0.17.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-searchads360_v0/v0.19.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-searchads360_v0
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Search Ads 360 Reporting API V0