google-ads-googleads 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 164db641c982021a9c51f5b3bf9e18a65f8e7b973338bd392b003d00f5235cc7
-  data.tar.gz: f84eeceb7819e6751d8b897eb92423bf9145df1118971033a7794d687690f199
+  metadata.gz: 4f66a636784daa5beeae7a3782c2b31b704e3ce520536c34f9840cb8096caf39
+  data.tar.gz: bf5149b98724cd03c6e336341743dfccb5e8853045e6c356bb540155d193b4ad
 SHA512:
-  metadata.gz: 9896edaac0beb4a622c4d1c7df3df42ad58767770772b8365afa275f045667d5ae0f5c808f3248077560386e966bad0ee9bd58281b1e5af41079d2cc2ccae5e0
-  data.tar.gz: e26923a7bc61d68228b1de9ab79d679c50c8e4ed97d9b80bda4eb3eeebe41eb0620f2ca833a63eb96a77961e0fac6e14ac6569512a37b5192921511a2b2ce839
+  metadata.gz: db80064d0a7ddd095e5fe9960547848285276fe01cc4d7d9c69eb2ae2c961a63cff3ea465cd84f0e4930493ec232550641cc82ceeb220fcaf2971a3920eaafcd
+  data.tar.gz: 77245ff7fb4efbaed9b6d34e5fcbe991a571d607a9e83d94a1f4bb73bc2c3552da1a088a3cc7838cad1c84a8bd63f13fc8e67031735f62a6755732f84e7e5897

data/ChangeLog

@@ -1,3 +1,5 @@
+2.2.0:
+  - Adding support for Google Ads API v1_3.
 2.1.1:
   - Fix "factories" implementation for Google's build system.
 

data/lib/google/ads/google_ads/factories/v1/enums.rb

@@ -396,6 +396,14 @@ module Google
               Google::Ads::GoogleAds::V1::Enums::TrackingCodeTypeEnum::TrackingCodeType.descriptor
             end
 
+            # Returns the descriptor for the CampaignDraftStatus enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the CampaignDraftStatus enum
+            def self.campaign_draft_status
+              require "google/ads/google_ads/v1/enums/campaign_draft_status_pb.rb"
+              Google::Ads::GoogleAds::V1::Enums::CampaignDraftStatusEnum::CampaignDraftStatus.descriptor
+            end
+
             # Returns the descriptor for the PolicyTopicEntryType enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the PolicyTopicEntryType enum
@@ -644,6 +652,22 @@ module Google
               Google::Ads::GoogleAds::V1::Enums::ManagerLinkStatusEnum::ManagerLinkStatus.descriptor
             end
 
+            # Returns the descriptor for the CampaignExperimentStatus enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the CampaignExperimentStatus enum
+            def self.campaign_experiment_status
+              require "google/ads/google_ads/v1/enums/campaign_experiment_status_pb.rb"
+              Google::Ads::GoogleAds::V1::Enums::CampaignExperimentStatusEnum::CampaignExperimentStatus.descriptor
+            end
+
+            # Returns the descriptor for the CampaignExperimentTrafficSplitType enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the CampaignExperimentTrafficSplitType enum
+            def self.campaign_experiment_traffic_split_type
+              require "google/ads/google_ads/v1/enums/campaign_experiment_traffic_split_type_pb.rb"
+              Google::Ads::GoogleAds::V1::Enums::CampaignExperimentTrafficSplitTypeEnum::CampaignExperimentTrafficSplitType.descriptor
+            end
+
             # Returns the descriptor for the ChangeStatusOperation enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the ChangeStatusOperation enum
@@ -868,6 +892,14 @@ module Google
               Google::Ads::GoogleAds::V1::Enums::UserListTypeEnum::UserListType.descriptor
             end
 
+            # Returns the descriptor for the CampaignCriterionStatus enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the CampaignCriterionStatus enum
+            def self.campaign_criterion_status
+              require "google/ads/google_ads/v1/enums/campaign_criterion_status_pb.rb"
+              Google::Ads::GoogleAds::V1::Enums::CampaignCriterionStatusEnum::CampaignCriterionStatus.descriptor
+            end
+
             # Returns the descriptor for the CriterionType enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the CriterionType enum
@@ -1548,6 +1580,14 @@ module Google
               Google::Ads::GoogleAds::V1::Enums::ExternalConversionSourceEnum::ExternalConversionSource.descriptor
             end
 
+            # Returns the descriptor for the HotelRateType enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the HotelRateType enum
+            def self.hotel_rate_type
+              require "google/ads/google_ads/v1/enums/hotel_rate_type_pb.rb"
+              Google::Ads::GoogleAds::V1::Enums::HotelRateTypeEnum::HotelRateType.descriptor
+            end
+
             # Returns the descriptor for the MonthOfYear enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the MonthOfYear enum
@@ -1884,6 +1924,14 @@ module Google
               Google::Ads::GoogleAds::V1::Errors::CampaignCriterionErrorEnum::CampaignCriterionError.descriptor
             end
 
+            # Returns the descriptor for the CampaignDraftError enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the CampaignDraftError enum
+            def self.campaign_draft_error
+              require "google/ads/google_ads/v1/errors/campaign_draft_error_pb.rb"
+              Google::Ads::GoogleAds::V1::Errors::CampaignDraftErrorEnum::CampaignDraftError.descriptor
+            end
+
             # Returns the descriptor for the CampaignError enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the CampaignError enum
@@ -1892,6 +1940,14 @@ module Google
               Google::Ads::GoogleAds::V1::Errors::CampaignErrorEnum::CampaignError.descriptor
             end
 
+            # Returns the descriptor for the CampaignExperimentError enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the CampaignExperimentError enum
+            def self.campaign_experiment_error
+              require "google/ads/google_ads/v1/errors/campaign_experiment_error_pb.rb"
+              Google::Ads::GoogleAds::V1::Errors::CampaignExperimentErrorEnum::CampaignExperimentError.descriptor
+            end
+
             # Returns the descriptor for the CampaignSharedSetError enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the CampaignSharedSetError enum
@@ -2180,6 +2236,14 @@ module Google
               Google::Ads::GoogleAds::V1::Errors::ListOperationErrorEnum::ListOperationError.descriptor
             end
 
+            # Returns the descriptor for the ManagerLinkError enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the ManagerLinkError enum
+            def self.manager_link_error
+              require "google/ads/google_ads/v1/errors/manager_link_error_pb.rb"
+              Google::Ads::GoogleAds::V1::Errors::ManagerLinkErrorEnum::ManagerLinkError.descriptor
+            end
+
             # Returns the descriptor for the MediaBundleError enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the MediaBundleError enum
@@ -2220,6 +2284,14 @@ module Google
               Google::Ads::GoogleAds::V1::Errors::NotEmptyErrorEnum::NotEmptyError.descriptor
             end
 
+            # Returns the descriptor for the NotWhitelistedError enum
+            #
+            # @return [Google::Protobuf::EnumDescriptor] for the NotWhitelistedError enum
+            def self.not_whitelisted_error
+              require "google/ads/google_ads/v1/errors/not_whitelisted_error_pb.rb"
+              Google::Ads::GoogleAds::V1::Errors::NotWhitelistedErrorEnum::NotWhitelistedError.descriptor
+            end
+
             # Returns the descriptor for the NullError enum
             #
             # @return [Google::Protobuf::EnumDescriptor] for the NullError enum

data/lib/google/ads/google_ads/factories/v1/operations.rb

@@ -156,6 +156,22 @@ module Google
               Google::Ads::GoogleAds::V1::Services::CampaignCriterionOperation.new
             end
 
+            # Create a new CampaignDraftOperation
+            #
+            # @return [Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation] the operation
+            def self.campaign_draft
+              require "google/ads/google_ads/v1/services/campaign_draft_service_pb.rb"
+              Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation.new
+            end
+
+            # Create a new CampaignExperimentOperation
+            #
+            # @return [Google::Ads::GoogleAds::V1::Services::CampaignExperimentOperation] the operation
+            def self.campaign_experiment
+              require "google/ads/google_ads/v1/services/campaign_experiment_service_pb.rb"
+              Google::Ads::GoogleAds::V1::Services::CampaignExperimentOperation.new
+            end
+
             # Create a new CampaignExtensionSettingOperation
             #
             # @return [Google::Ads::GoogleAds::V1::Services::CampaignExtensionSettingOperation] the operation
@@ -795,6 +811,56 @@ module Google
                 op
               end
 
+              # A convenience method for creating an CampaignDraftOperation instance with
+              # its "create" field prepopulated with an CampaignDraft instance.
+              #
+              # @overload campaign_draft
+              #   creates an operation instance, yielding a newly fabricated CampaignDraft
+              #   which can be used for setting attributes on the newly created resource
+              # @overload campaign_draft(res)
+              #   creates an operation instance, with the resource to be created
+              #   set to the passed value (res)
+              #   @param res [Google::Ads::GoogleAds::V1::Resources::CampaignDraft]
+              #     a resource instance to be used for creation in this operation.
+              #
+              # @return [Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation] instance that will create the resource
+              def self.campaign_draft(res = nil, &blk)
+                require "google/ads/google_ads/v1/services/campaign_draft_service_pb.rb"
+                op = Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation.new
+                if !res.nil?
+                  op["create"] = res
+                elsif !blk.nil?
+                  op["create"] = Factories::V1::Resources.campaign_draft(&blk)
+                end
+
+                op
+              end
+
+              # A convenience method for creating an CampaignExperimentOperation instance with
+              # its "create" field prepopulated with an CampaignExperiment instance.
+              #
+              # @overload campaign_experiment
+              #   creates an operation instance, yielding a newly fabricated CampaignExperiment
+              #   which can be used for setting attributes on the newly created resource
+              # @overload campaign_experiment(res)
+              #   creates an operation instance, with the resource to be created
+              #   set to the passed value (res)
+              #   @param res [Google::Ads::GoogleAds::V1::Resources::CampaignExperiment]
+              #     a resource instance to be used for creation in this operation.
+              #
+              # @return [Google::Ads::GoogleAds::V1::Services::CampaignExperimentOperation] instance that will create the resource
+              def self.campaign_experiment(res = nil, &blk)
+                require "google/ads/google_ads/v1/services/campaign_experiment_service_pb.rb"
+                op = Google::Ads::GoogleAds::V1::Services::CampaignExperimentOperation.new
+                if !res.nil?
+                  op["create"] = res
+                elsif !blk.nil?
+                  op["create"] = Factories::V1::Resources.campaign_experiment(&blk)
+                end
+
+                op
+              end
+
               # A convenience method for creating an CampaignExtensionSettingOperation instance with
               # its "create" field prepopulated with an CampaignExtensionSetting instance.
               #
@@ -1999,6 +2065,45 @@ module Google
                 op
               end
 
+              # A convenience method for creating an CampaignDraftOperation instance with
+              # its "update" field prepopulated with an CampaignDraft instance, and
+              # its "update_mask" field populated as needed to send the updates to the API.
+              #
+              # @overload #campaign_draft(path, &blk)
+              #   @param path [String] a resource path for the resource to update
+              #   @yield [Google::Ads::GoogleAds::V1::Resources::CampaignDraft] a new instance of the resource for this update operation, on
+              #     which fields can be set to update
+              #
+              # @overload #campaign_draft(resource, &blk)
+              #   @param resource [Google::Ads::GoogleAds::V1::Resources::CampaignDraft] a resource instance to update
+              #   @yield the passed block is called and updates against `resource` are recordered in the update mask
+              # @return [Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation] the operation instance to update the resource
+              def self.campaign_draft(resource_or_path, &blk)
+                require "google/ads/google_ads/v1/services/campaign_draft_service_pb.rb"
+                res = case resource_or_path
+                when Google::Ads::GoogleAds::V1::Resources::CampaignDraft
+                  resource_or_path
+                # got a resource path
+                when String
+                  obj = Google::Ads::GoogleAds::V1::Resources::CampaignDraft.new
+                  obj.resource_name = resource_or_path
+                  obj
+                else
+                  unless Google::Ads::GoogleAds::V1::Resources::CampaignDraft === res
+                    raise ArgumentError.new(
+                      "Called #{__method__} with instance of wrong type:"\
+                      " #{res.class} want #{operation.update_class}"\
+                      " or String representing resource name"
+                    )
+                  end
+                end
+
+                op = Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation.new
+                op["update_mask"] = Google::Ads::GoogleAds::FieldMaskUtil.with(res, &blk)
+                op["update"] = res
+                op
+              end
+
               # A convenience method for creating an CampaignExtensionSettingOperation instance with
               # its "update" field prepopulated with an CampaignExtensionSetting instance, and
               # its "update_mask" field populated as needed to send the updates to the API.
@@ -3244,6 +3349,26 @@ module Google
                 op
               end
 
+              # A convenience method for creationg an CampaignDraftOperation instance with
+              # its "remove" field preopulated with a resource path corresponding to the resource to be removed.
+              #
+              # @param path [String] the resource name of the resource to delete.
+              def self.campaign_draft(path)
+                op = Google::Ads::GoogleAds::V1::Services::CampaignDraftOperation.new
+                op["remove"] = path
+                op
+              end
+
+              # A convenience method for creationg an CampaignExperimentOperation instance with
+              # its "remove" field preopulated with a resource path corresponding to the resource to be removed.
+              #
+              # @param path [String] the resource name of the resource to delete.
+              def self.campaign_experiment(path)
+                op = Google::Ads::GoogleAds::V1::Services::CampaignExperimentOperation.new
+                op["remove"] = path
+                op
+              end
+
               # A convenience method for creationg an CampaignExtensionSettingOperation instance with
               # its "remove" field preopulated with a resource path corresponding to the resource to be removed.
               #