Changes for release v18_0. (#128)

Build.PL

@@ -42,21 +42,21 @@ $build_sc->new(
   create_makefile_pl => "traditional",
   dist_abstract      => "Google Ads API Client Library for Perl",
   dist_name          => "Google-Ads-GoogleAds-Client",
-  dist_version       => "24.0.0",
+  dist_version       => "25.0.0",
   no_index           => {
     namespace => [
-      "Google::Ads::GoogleAds::V15::Enums",
-      "Google::Ads::GoogleAds::V15::Common",
-      "Google::Ads::GoogleAds::V15::Resources",
-      "Google::Ads::GoogleAds::V15::Services",
       "Google::Ads::GoogleAds::V16::Enums",
       "Google::Ads::GoogleAds::V16::Common",
       "Google::Ads::GoogleAds::V16::Resources",
       "Google::Ads::GoogleAds::V16::Services",
-	  "Google::Ads::GoogleAds::V17::Enums",
+      "Google::Ads::GoogleAds::V17::Enums",
       "Google::Ads::GoogleAds::V17::Common",
       "Google::Ads::GoogleAds::V17::Resources",
       "Google::Ads::GoogleAds::V17::Services",
+      "Google::Ads::GoogleAds::V18::Enums",
+      "Google::Ads::GoogleAds::V18::Common",
+      "Google::Ads::GoogleAds::V18::Resources",
+      "Google::Ads::GoogleAds::V18::Services",
     ],
   },
   requires           => {

CHANGELOG.md

@@ -1,3 +1,9 @@
+25.0.0 - 2024-10-16
+-------------------
+- Added support for Google Ads API v18.
+- Updated example get_all_disapproved_ads to set returnTotalResultsCount
+  on new searchSettings request field.
+
 24.0.0 - 2024-08-08
 -------------------
 - Added support for Google Ads API v17_1.

examples/account_management/create_customer.pl

@@ -29,7 +29,7 @@
 use lib "$Bin/../../lib";
 use Google::Ads::GoogleAds::Client;
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
-use Google::Ads::GoogleAds::V17::Resources::Customer;
+use Google::Ads::GoogleAds::V18::Resources::Customer;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -51,7 +51,7 @@ sub create_customer {
   my ($api_client, $manager_customer_id) = @_;
 
   # Initialize a customer to be created.
-  my $customer = Google::Ads::GoogleAds::V17::Resources::Customer->new({
+  my $customer = Google::Ads::GoogleAds::V18::Resources::Customer->new({
       descriptiveName => "Account created with CustomerService on #" . uniqid(),
 
       # For a list of valid currency codes and time zones, see this documentation:

examples/account_management/get_account_hierarchy.pl

@@ -32,7 +32,7 @@
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
 use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
 use
-  Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;
+  Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -177,7 +177,7 @@ ()
       Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
         service => $google_ads_service,
         request =>
-          Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
+          Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
           ->new({
             customerId => $customer_id_to_search,
             query      => $search_query,

examples/account_management/get_change_details.pl

@@ -27,12 +27,12 @@
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
 use Google::Ads::GoogleAds::Utils::SearchGoogleAdsIterator;
 use Google::Ads::GoogleAds::Utils::FieldMasks;
-use Google::Ads::GoogleAds::V17::Enums::ResourceChangeOperationEnum
+use Google::Ads::GoogleAds::V18::Enums::ResourceChangeOperationEnum
   qw(CREATE UPDATE);
-use Google::Ads::GoogleAds::V17::Enums::ChangeEventResourceTypeEnum
+use Google::Ads::GoogleAds::V18::Enums::ChangeEventResourceTypeEnum
   qw(AD AD_GROUP AD_GROUP_AD AD_GROUP_ASSET AD_GROUP_CRITERION AD_GROUP_BID_MODIFIER ASSET ASSET_SET ASSET_SET_ASSET CAMPAIGN CAMPAIGN_ASSET CAMPAIGN_ASSET_SET CAMPAIGN_BUDGET CAMPAIGN_CRITERION AD_GROUP_FEED CAMPAIGN_FEED CUSTOMER_ASSET FEED FEED_ITEM);
 use
-  Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsRequest;
+  Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsRequest;
 
 use Getopt::Long qw(:config auto_help);
 use JSON::XS;
@@ -72,7 +72,7 @@ sub get_change_details {
   # Create a search Google Ads request that will retrieve all change events using
   # pages of the specified page size.
   my $search_request =
-    Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsRequest
+    Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsRequest
     ->new({
       customerId => $customer_id,
       query      => $search_query

examples/account_management/get_change_summary.pl

@@ -26,10 +26,10 @@
 use Google::Ads::GoogleAds::Client;
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
 use Google::Ads::GoogleAds::Utils::SearchGoogleAdsIterator;
-use Google::Ads::GoogleAds::V17::Enums::ChangeStatusResourceTypeEnum
+use Google::Ads::GoogleAds::V18::Enums::ChangeStatusResourceTypeEnum
   qw(AD_GROUP AD_GROUP_AD AD_GROUP_CRITERION CAMPAIGN CAMPAIGN_CRITERION FEED FEED_ITEM AD_GROUP_FEED CAMPAIGN_FEED AD_GROUP_BID_MODIFIER);
 use
-  Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsRequest;
+  Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsRequest;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -73,7 +73,7 @@ sub get_change_summary {
   # Create a search Google Ads request that will retrieve all change statuses using
   # pages of the specified page size.
   my $search_request =
-    Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsRequest
+    Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsRequest
     ->new({
       customerId => $customer_id,
       query      => $search_query

examples/account_management/invite_user_with_access_role.pl

@@ -25,9 +25,9 @@
 use lib "$Bin/../../lib";
 use Google::Ads::GoogleAds::Client;
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
-use Google::Ads::GoogleAds::V17::Resources::CustomerUserAccessInvitation;
+use Google::Ads::GoogleAds::V18::Resources::CustomerUserAccessInvitation;
 use
-  Google::Ads::GoogleAds::V17::Services::CustomerUserAccessInvitationService::CustomerUserAccessInvitationOperation;
+  Google::Ads::GoogleAds::V18::Services::CustomerUserAccessInvitationService::CustomerUserAccessInvitationOperation;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -43,7 +43,7 @@
 # Running the example with -h will print the command line usage.
 my $customer_id   = "INSERT_CUSTOMER_ID_HERE";
 my $email_address = "INSERT_EMAIL_ADDRESS_HERE";
-# See Google::Ads::GoogleAds::V17::Enums::AccessRoleEnum for optional values.
+# See Google::Ads::GoogleAds::V18::Enums::AccessRoleEnum for optional values.
 my $access_role = "INSERT_ACCESS_ROLE_HERE";
 
 # [START invite_user_with_access_role]
@@ -52,14 +52,14 @@ sub invite_user_with_access_role {
 
   # Create the user access invitation.
   my $user_access_invitation =
-    Google::Ads::GoogleAds::V17::Resources::CustomerUserAccessInvitation->new({
+    Google::Ads::GoogleAds::V18::Resources::CustomerUserAccessInvitation->new({
       emailAddress => $email_address,
       accessRole   => $access_role
     });
 
   # Create the user access invitation operation.
   my $invitation_operation =
-    Google::Ads::GoogleAds::V17::Services::CustomerUserAccessInvitationService::CustomerUserAccessInvitationOperation
+    Google::Ads::GoogleAds::V18::Services::CustomerUserAccessInvitationService::CustomerUserAccessInvitationOperation
     ->new({create => $user_access_invitation});
 
   # Send the user access invitation.

examples/account_management/link_manager_to_client.pl

@@ -26,15 +26,15 @@
 use Google::Ads::GoogleAds::Client;
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
 use Google::Ads::GoogleAds::Utils::FieldMasks;
-use Google::Ads::GoogleAds::V17::Resources::CustomerClientLink;
-use Google::Ads::GoogleAds::V17::Resources::CustomerManagerLink;
-use Google::Ads::GoogleAds::V17::Enums::ManagerLinkStatusEnum
+use Google::Ads::GoogleAds::V18::Resources::CustomerClientLink;
+use Google::Ads::GoogleAds::V18::Resources::CustomerManagerLink;
+use Google::Ads::GoogleAds::V18::Enums::ManagerLinkStatusEnum
   qw(PENDING ACTIVE);
 use
-  Google::Ads::GoogleAds::V17::Services::CustomerClientLinkService::CustomerClientLinkOperation;
+  Google::Ads::GoogleAds::V18::Services::CustomerClientLinkService::CustomerClientLinkOperation;
 use
-  Google::Ads::GoogleAds::V17::Services::CustomerManagerLinkService::CustomerManagerLinkOperation;
-use Google::Ads::GoogleAds::V17::Utils::ResourceNames;
+  Google::Ads::GoogleAds::V18::Services::CustomerManagerLinkService::CustomerManagerLinkOperation;
+use Google::Ads::GoogleAds::V18::Utils::ResourceNames;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -66,16 +66,16 @@ sub link_manager_to_client {
 
   # Create a customer client link.
   my $api_client_link =
-    Google::Ads::GoogleAds::V17::Resources::CustomerClientLink->new({
+    Google::Ads::GoogleAds::V18::Resources::CustomerClientLink->new({
       clientCustomer =>
-        Google::Ads::GoogleAds::V17::Utils::ResourceNames::customer(
+        Google::Ads::GoogleAds::V18::Utils::ResourceNames::customer(
         $api_client_customer_id),
       status => PENDING
     });
 
   # Create a customer client link operation.
   my $api_client_link_operation =
-    Google::Ads::GoogleAds::V17::Services::CustomerClientLinkService::CustomerClientLinkOperation
+    Google::Ads::GoogleAds::V18::Services::CustomerClientLinkService::CustomerClientLinkOperation
     ->new({
       create => $api_client_link
     });
@@ -110,7 +110,7 @@ sub link_manager_to_client {
     $search_response->{results}[0]{customerClientLink}{managerLinkId};
 
   my $manager_link_resource_name =
-    Google::Ads::GoogleAds::V17::Utils::ResourceNames::customer_manager_link(
+    Google::Ads::GoogleAds::V18::Utils::ResourceNames::customer_manager_link(
     $api_client_customer_id, $manager_customer_id, $manager_link_id);
 
   # Step 3: Accept the manager customer's link invitation while authenticating
@@ -119,14 +119,14 @@ sub link_manager_to_client {
 
   # Create a customer manager link.
   my $manager_link =
-    Google::Ads::GoogleAds::V17::Resources::CustomerManagerLink->new({
+    Google::Ads::GoogleAds::V18::Resources::CustomerManagerLink->new({
       resourceName => $manager_link_resource_name,
       status       => ACTIVE
     });
 
   # Create a customer manager link operation.
   my $manager_link_operation =
-    Google::Ads::GoogleAds::V17::Services::CustomerManagerLinkService::CustomerManagerLinkOperation
+    Google::Ads::GoogleAds::V18::Services::CustomerManagerLinkService::CustomerManagerLinkOperation
     ->new({
       update     => $manager_link,
       updateMask => all_set_fields_of($manager_link)});

examples/account_management/update_user_access.pl

@@ -30,12 +30,12 @@
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
 use Google::Ads::GoogleAds::Utils::SearchGoogleAdsIterator;
 use Google::Ads::GoogleAds::Utils::FieldMasks;
-use Google::Ads::GoogleAds::V17::Resources::CustomerUserAccess;
+use Google::Ads::GoogleAds::V18::Resources::CustomerUserAccess;
 use
-  Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsRequest;
+  Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsRequest;
 use
-  Google::Ads::GoogleAds::V17::Services::CustomerUserAccessService::CustomerUserAccessOperation;
-use Google::Ads::GoogleAds::V17::Utils::ResourceNames;
+  Google::Ads::GoogleAds::V18::Services::CustomerUserAccessService::CustomerUserAccessOperation;
+use Google::Ads::GoogleAds::V18::Utils::ResourceNames;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -51,7 +51,7 @@
 # Running the example with -h will print the command line usage.
 my $customer_id   = "INSERT_CUSTOMER_ID_HERE";
 my $email_address = "INSERT_EMAIL_ADDRESS_HERE";
-# See Google::Ads::GoogleAds::V17::Enums::AccessRoleEnum for optional values.
+# See Google::Ads::GoogleAds::V18::Enums::AccessRoleEnum for optional values.
 my $access_role = "INSERT_ACCESS_ROLE_HERE";
 
 sub update_user_access {
@@ -79,7 +79,7 @@ sub get_user_access {
 
   # Create a search Google Ads request that will retrieve the customer user access.
   my $search_request =
-    Google::Ads::GoogleAds::V17::Services::GoogleAdsService::SearchGoogleAdsRequest
+    Google::Ads::GoogleAds::V18::Services::GoogleAdsService::SearchGoogleAdsRequest
     ->new({
       customerId => $customer_id,
       query      => $search_query
@@ -115,17 +115,17 @@ sub modify_user_access {
 
   # Create the modified user access.
   my $user_access =
-    Google::Ads::GoogleAds::V17::Resources::CustomerUserAccess->new({
+    Google::Ads::GoogleAds::V18::Resources::CustomerUserAccess->new({
       resourceName =>
-        Google::Ads::GoogleAds::V17::Utils::ResourceNames::customer_user_access(
+        Google::Ads::GoogleAds::V18::Utils::ResourceNames::customer_user_access(
         $customer_id, $user_id
         ),
       accessRole => $access_role
     });
 
   # Create the operation.
   my $user_access_operation =
-    Google::Ads::GoogleAds::V17::Services::CustomerUserAccessService::CustomerUserAccessOperation
+    Google::Ads::GoogleAds::V18::Services::CustomerUserAccessService::CustomerUserAccessOperation
     ->new({
       update     => $user_access,
       updateMask => all_set_fields_of($user_access)});

examples/account_management/verify_advertiser_identity.pl

@@ -26,10 +26,10 @@
 use lib "$Bin/../../lib";
 use Google::Ads::GoogleAds::Client;
 use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
-use Google::Ads::GoogleAds::V17::Enums::IdentityVerificationProgramEnum
+use Google::Ads::GoogleAds::V18::Enums::IdentityVerificationProgramEnum
   qw (ADVERTISER_IDENTITY_VERIFICATION);
 use
-  Google::Ads::GoogleAds::V17::Services::IdentityVerificationService::StartIdentityVerificationRequest;
+  Google::Ads::GoogleAds::V18::Services::IdentityVerificationService::StartIdentityVerificationRequest;
 
 use Getopt::Long qw(:config auto_help);
 use Pod::Usage;
@@ -104,7 +104,7 @@ sub start_identity_verification {
   my ($api_client, $customer_id) = @_;
 
   my $request =
-    Google::Ads::GoogleAds::V17::Services::IdentityVerificationService::StartIdentityVerificationRequest
+    Google::Ads::GoogleAds::V18::Services::IdentityVerificationService::StartIdentityVerificationRequest
     ->new({
       customerId          => $customer_id,
       verificationProgram => ADVERTISER_IDENTITY_VERIFICATION