google-apis-searchads360_v0 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61dd970e70eae5a527ec4fd96faa209dca9ad7c6af0b895da8248e4e4ef96b7c
-  data.tar.gz: ad6eec99297d16d23960ddc1d285edbd99e5525e24f929603c0333517f203538
+  metadata.gz: 4ebc31b008300f4ae35bea84447e02ccdd03bac4fdd427713037d1ac41d2c01a
+  data.tar.gz: 3008ccb8261cc675a090a83a61d3f8883c4d146c1678a78db1aac4f49d07daca
 SHA512:
-  metadata.gz: e67c29d15e40b75bffaa429b15093a9b062e94ee03e50038f83e2330b3aa9c31c493629bd881a1d5b027ca0b5c459090247cb2e8f4d09f57ef6c7f5deeb64dba
-  data.tar.gz: 228e8701bd30e473ecda95be6ea7c9f38159c2551cd8455483471d4357bce51abe4d6f54b15b342e473611a019018117af5bd2b7c3442b84de267af21997b82d
+  metadata.gz: 6adea95a64d4af82934bdae049da830ee85aa8073a0feff144fe9982cf5d8f1be090c5d2d85d3bee7d353d74a04819ca5c492aaa1e98f210699c1ed538c1c7cd
+  data.tar.gz: a103fb2c0617bb05a71ba7a20f0387e8682d74b650967e421824f838ddcedc5439ba2f50f314fe3f25c3d38db252ab0123e70df7141e70658a920b26afd47096

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 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

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

@@ -4254,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.
@@ -4299,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)
@@ -4308,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
@@ -4526,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"
@@ -4652,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)
@@ -4674,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
@@ -7712,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
@@ -8035,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]
@@ -8069,6 +8209,13 @@ 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]
@@ -8325,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]
@@ -8344,12 +8499,14 @@ 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)
@@ -8395,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.18.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 = "20241002"
+      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,6 +622,12 @@ 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
       
@@ -910,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
       
@@ -1990,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'
@@ -1999,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
@@ -2057,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'
@@ -2087,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
@@ -2793,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
@@ -2885,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
@@ -2897,6 +2948,8 @@ 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
@@ -2987,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.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-06 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.18.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