I've updated the internal API version references from v17 to v20 for examples/campaign_management.

I also updated `GoogleAdsClient.load_from_storage` to use v20 instead of v19.

Author: google-labs-jules[bot]

examples/campaign_management/add_campaign_labels.py

@@ -23,18 +23,18 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v17.services.services.campaign_label_service import (
+from google.ads.googleads.v20.services.services.campaign_label_service import (
     CampaignLabelServiceClient,
 )
-from google.ads.googleads.v17.services.services.campaign_service import (
+from google.ads.googleads.v20.services.services.campaign_service import (
     CampaignServiceClient,
 )
-from google.ads.googleads.v17.services.services.label_service import LabelServiceClient
-from google.ads.googleads.v17.services.types.campaign_label_service import (
+from google.ads.googleads.v20.services.services.label_service import LabelServiceClient
+from google.ads.googleads.v20.services.types.campaign_label_service import (
     MutateCampaignLabelsResponse,
 )
-from google.ads.googleads.v17.resources.types.campaign_label import CampaignLabel
-from google.ads.googleads.v17.services.types.google_ads_service import GoogleAdsRow
+from google.ads.googleads.v20.resources.types.campaign_label import CampaignLabel
+from google.ads.googleads.v20.services.types.google_ads_service import GoogleAdsRow
 
 
 # [START add_campaign_labels]
@@ -118,7 +118,7 @@ def main(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
     try:
         main(googleads_client, args.customer_id, args.label_id, args.campaign_ids)
     except GoogleAdsException as ex:

examples/campaign_management/add_complete_campaigns_using_batch_job.py

@@ -26,32 +26,32 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v17.services.services.batch_job_service import (
+from google.ads.googleads.v20.services.services.batch_job_service import (
     BatchJobServiceClient,
 )
-from google.ads.googleads.v17.services.types.batch_job_service import (
+from google.ads.googleads.v20.services.types.batch_job_service import (
     MutateBatchJobResponse,
     AddBatchJobOperationsResponse,
     ListBatchJobResultsRequest,
     ListBatchJobResultsResponse,
 )
-from google.ads.googleads.v17.services.types.common import MutateOperation
-from google.ads.googleads.v17.resources.types.batch_job import BatchJob
-from google.ads.googleads.v17.services.types.campaign_budget_service import (
+from google.ads.googleads.v20.services.types.common import MutateOperation
+from google.ads.googleads.v20.resources.types.batch_job import BatchJob
+from google.ads.googleads.v20.services.types.campaign_budget_service import (
     CampaignBudgetOperation,
 )
-from google.ads.googleads.v17.services.types.campaign_service import CampaignOperation
-from google.ads.googleads.v17.services.types.campaign_criterion_service import (
+from google.ads.googleads.v20.services.types.campaign_service import CampaignOperation
+from google.ads.googleads.v20.services.types.campaign_criterion_service import (
     CampaignCriterionOperation,
 )
-from google.ads.googleads.v17.services.types.ad_group_service import AdGroupOperation
-from google.ads.googleads.v17.services.types.ad_group_criterion_service import (
+from google.ads.googleads.v20.services.types.ad_group_service import AdGroupOperation
+from google.ads.googleads.v20.services.types.ad_group_criterion_service import (
     AdGroupCriterionOperation,
 )
-from google.ads.googleads.v17.services.types.ad_group_ad_service import (
+from google.ads.googleads.v20.services.types.ad_group_ad_service import (
     AdGroupAdOperation,
 )
-from google.ads.googleads.v17.services.types.batch_job_service import BatchJobOperation
+from google.ads.googleads.v20.services.types.batch_job_service import BatchJobOperation
 from google.api_core.operation import Operation
 
 NUMBER_OF_CAMPAIGNS_TO_ADD: int = 2
@@ -717,6 +717,6 @@ def handle_googleads_exception(exception: GoogleAdsException) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
 
     asyncio.run(main(googleads_client, args.customer_id))

examples/campaign_management/create_experiment.py

@@ -27,28 +27,28 @@
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.api_core import protobuf_helpers
-from google.ads.googleads.v17.services.types.experiment_service import (
+from google.ads.googleads.v20.services.types.experiment_service import (
     ExperimentOperation,
     MutateExperimentsResponse,
 )
-from google.ads.googleads.v17.services.types.experiment_arm_service import (
+from google.ads.googleads.v20.services.types.experiment_arm_service import (
     ExperimentArmOperation,
     MutateExperimentArmsRequest,
     MutateExperimentArmsResponse,
 )
-from google.ads.googleads.v17.resources.types.experiment import Experiment
-from google.ads.googleads.v17.resources.types.experiment_arm import ExperimentArm
-from google.ads.googleads.v17.services.services.experiment_service import (
+from google.ads.googleads.v20.resources.types.experiment import Experiment
+from google.ads.googleads.v20.resources.types.experiment_arm import ExperimentArm
+from google.ads.googleads.v20.services.services.experiment_service import (
     ExperimentServiceClient,
 )
-from google.ads.googleads.v17.services.services.experiment_arm_service import (
+from google.ads.googleads.v20.services.services.experiment_arm_service import (
     ExperimentArmServiceClient,
 )
-from google.ads.googleads.v17.services.services.campaign_service import (
+from google.ads.googleads.v20.services.services.campaign_service import (
     CampaignServiceClient,
 )
-from google.ads.googleads.v17.services.types.campaign_service import CampaignOperation
-from google.ads.googleads.v17.resources.types.campaign import Campaign
+from google.ads.googleads.v20.services.types.campaign_service import CampaignOperation
+from google.ads.googleads.v20.resources.types.campaign import Campaign
 
 
 def main(client: GoogleAdsClient, customer_id: str, base_campaign_id: str) -> None:
@@ -242,7 +242,7 @@ def modify_draft_campaign(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.base_campaign_id)

examples/campaign_management/get_all_disapproved_ads.py

@@ -19,23 +19,23 @@
 import sys
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v17.services.services.google_ads_service import (
+from google.ads.googleads.v20.services.services.google_ads_service import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v17.services.types.google_ads_service import (
+from google.ads.googleads.v20.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchGoogleAdsResponse,
 )
-from google.ads.googleads.v17.resources.types.ad_group_ad import AdGroupAd
-from google.ads.googleads.v17.resources.types.ad import Ad
-from google.ads.googleads.v17.enums.types.policy_approval_status import (
+from google.ads.googleads.v20.resources.types.ad_group_ad import AdGroupAd
+from google.ads.googleads.v20.resources.types.ad import Ad
+from google.ads.googleads.v20.enums.types.policy_approval_status import (
     PolicyApprovalStatusEnum,
 )
-from google.ads.googleads.v17.common.types.policy import (
+from google.ads.googleads.v20.common.types.policy import (
     PolicyTopicEntry,
     PolicyTopicEvidence,
 )
-from google.ads.googleads.v17.services.types.google_ads_service import GoogleAdsRow
+from google.ads.googleads.v20.services.types.google_ads_service import GoogleAdsRow
 
 
 def main(client: GoogleAdsClient, customer_id: str, campaign_id: str) -> None:
@@ -117,7 +117,7 @@ def main(client: GoogleAdsClient, customer_id: str, campaign_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/campaign_management/set_ad_parameters.py

@@ -21,18 +21,18 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v17.services.services.ad_group_criterion_service import (
+from google.ads.googleads.v20.services.services.ad_group_criterion_service import (
     AdGroupCriterionServiceClient,
 )
-from google.ads.googleads.v17.services.services.ad_parameter_service import (
+from google.ads.googleads.v20.services.services.ad_parameter_service import (
     AdParameterServiceClient,
 )
-from google.ads.googleads.v17.services.types.ad_parameter_service import (
+from google.ads.googleads.v20.services.types.ad_parameter_service import (
     AdParameterOperation,
     MutateAdParametersResponse,
 )
-from google.ads.googleads.v17.resources.types.ad_parameter import AdParameter
-from google.ads.googleads.v17.services.types.ad_parameter_service import (
+from google.ads.googleads.v20.resources.types.ad_parameter import AdParameter
+from google.ads.googleads.v20.services.types.ad_parameter_service import (
     MutateAdParameterResult,
 )
 
@@ -153,6 +153,6 @@ def create_ad_parameter(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
 
     main(googleads_client, args.customer_id, args.ad_group_id, args.criterion_id)

examples/campaign_management/update_campaign_criterion_bid_modifier.py

@@ -20,14 +20,14 @@
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.api_core import protobuf_helpers
-from google.ads.googleads.v17.services.services.campaign_criterion_service import (
+from google.ads.googleads.v20.services.services.campaign_criterion_service import (
     CampaignCriterionServiceClient,
 )
-from google.ads.googleads.v17.services.types.campaign_criterion_service import (
+from google.ads.googleads.v20.services.types.campaign_criterion_service import (
     CampaignCriterionOperation,
     MutateCampaignCriteriaResponse,
 )
-from google.ads.googleads.v17.resources.types.campaign_criterion import (
+from google.ads.googleads.v20.resources.types.campaign_criterion import (
     CampaignCriterion,
 )
 
@@ -108,7 +108,7 @@ def main(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/campaign_management/validate_ad.py

@@ -26,23 +26,23 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v17.services.types.ad_group_ad_service import (
+from google.ads.googleads.v20.services.types.ad_group_ad_service import (
     AdGroupAdOperation,
     MutateAdGroupAdsRequest,
 )
-from google.ads.googleads.v17.resources.types.ad_group_ad import AdGroupAd
-from google.ads.googleads.v17.services.services.ad_group_service import (
+from google.ads.googleads.v20.resources.types.ad_group_ad import AdGroupAd
+from google.ads.googleads.v20.services.services.ad_group_service import (
     AdGroupServiceClient,
 )
-from google.ads.googleads.v17.common.types.ad_type_infos import AdTextAsset
-from google.ads.googleads.v17.services.services.ad_group_ad_service import (
+from google.ads.googleads.v20.common.types.ad_type_infos import AdTextAsset
+from google.ads.googleads.v20.services.services.ad_group_ad_service import (
     AdGroupAdServiceClient,
 )
-from google.ads.googleads.v17.enums.types.policy_finding_error import (
+from google.ads.googleads.v20.enums.types.policy_finding_error import (
     PolicyFindingErrorEnum,
 )
-from google.ads.googleads.v17.common.types.policy import PolicyTopicEntry
-from google.ads.googleads.v17.errors.types.google_ads_failure import GoogleAdsError
+from google.ads.googleads.v20.common.types.policy import PolicyTopicEntry
+from google.ads.googleads.v20.errors.types.google_ads_failure import GoogleAdsError
 
 
 def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str) -> None:
@@ -148,6 +148,6 @@ def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(version="v20")
 
     main(googleads_client, args.customer_id, args.ad_group_id)