Add type annotations to examples/planning (#1017)

google-labs-jules[bot] · web-flow · commit d3c9cdf315d6 · 2025-07-30T13:29:03.000-04:00
diff --git a/examples/account_management/link_manager_to_client.py b/examples/account_management/link_manager_to_client.py
@@ -16,7 +16,6 @@
 
 import argparse
 import sys
-from typing import List  # For operations list
 
 from google.api_core import protobuf_helpers
 from google.protobuf.field_mask_pb2 import FieldMask
diff --git a/examples/account_management/update_user_access.py b/examples/account_management/update_user_access.py
@@ -43,9 +43,6 @@
     CustomerUserAccessOperation,
     MutateCustomerUserAccessResponse,
 )
-from google.ads.googleads.v20.enums.types.access_role import (
-    AccessRoleEnum,
-)  # For type of customer_user_access.access_role
 
 from google.api_core import protobuf_helpers
 from google.protobuf.field_mask_pb2 import FieldMask
diff --git a/examples/advanced_operations/add_ad_customizer.py b/examples/advanced_operations/add_ad_customizer.py
@@ -20,7 +20,6 @@
 
 
 import argparse
-from datetime import datetime
 import sys
 from uuid import uuid4
 
diff --git a/examples/advanced_operations/add_dynamic_page_feed_asset.py b/examples/advanced_operations/add_dynamic_page_feed_asset.py
@@ -15,7 +15,6 @@
 """Adds a page feed with URLs for a Dynamic Search Ads campaign."""
 
 import argparse
-import resource
 import sys
 
 from examples.utils.example_helpers import get_printable_datetime
diff --git a/examples/assets/add_call.py b/examples/assets/add_call.py
@@ -16,20 +16,16 @@
 
 
 import argparse
-from typing import Optional, Sequence
+from typing import Optional
 import sys
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.ads.googleads.v20.services.types.asset_service import AssetOperation
 from google.ads.googleads.v20.resources.types.asset import Asset
 from google.ads.googleads.v20.common.types.criteria import AdScheduleInfo
-from google.ads.googleads.v20.enums.types.day_of_week import DayOfWeekEnum
-from google.ads.googleads.v20.enums.types.minute_of_hour import MinuteOfHourEnum
-from google.ads.googleads.v20.enums.types.call_conversion_reporting_state import CallConversionReportingStateEnum
 from google.ads.googleads.v20.services.types.customer_asset_service import CustomerAssetOperation
 from google.ads.googleads.v20.resources.types.customer_asset import CustomerAsset
-from google.ads.googleads.v20.enums.types.asset_field_type import AssetFieldTypeEnum
 
 # Country code is a two-letter ISO-3166 code, for a list of all codes see:
 # https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17
diff --git a/examples/assets/add_hotel_callout.py b/examples/assets/add_hotel_callout.py
@@ -16,7 +16,7 @@
 
 
 import argparse
-from typing import List, Sequence
+from typing import List
 import sys
 
 
@@ -26,7 +26,6 @@
 from google.ads.googleads.v20.resources.types.asset import Asset
 from google.ads.googleads.v20.services.types.customer_asset_service import CustomerAssetOperation
 from google.ads.googleads.v20.resources.types.customer_asset import CustomerAsset
-from google.ads.googleads.v20.enums.types.asset_field_type import AssetFieldTypeEnum
 
 
 def main(
diff --git a/examples/assets/add_lead_form_asset.py b/examples/assets/add_lead_form_asset.py
@@ -19,7 +19,6 @@
 
 
 import argparse
-from typing import List, Sequence
 import sys
 from uuid import uuid4
 
@@ -28,14 +27,10 @@
 from google.ads.googleads.v20.services.types.asset_service import AssetOperation
 from google.ads.googleads.v20.resources.types.asset import Asset
 from google.ads.googleads.v20.common.types.asset_types import LeadFormAsset
-from google.ads.googleads.v20.enums.types.lead_form_call_to_action_type import LeadFormCallToActionTypeEnum
-from google.ads.googleads.v20.enums.types.lead_form_field_user_input_type import LeadFormFieldUserInputTypeEnum
 from google.ads.googleads.v20.common.types.asset_types import LeadFormField
-from google.ads.googleads.v20.enums.types.lead_form_post_submit_call_to_action_type import LeadFormPostSubmitCallToActionTypeEnum
 from google.ads.googleads.v20.common.types.asset_types import LeadFormDeliveryMethod
 from google.ads.googleads.v20.services.types.campaign_asset_service import CampaignAssetOperation
 from google.ads.googleads.v20.resources.types.campaign_asset import CampaignAsset
-from google.ads.googleads.v20.enums.types.asset_field_type import AssetFieldTypeEnum
 
 
 def main(
diff --git a/examples/assets/add_prices.py b/examples/assets/add_prices.py
@@ -16,7 +16,7 @@
 
 
 import argparse
-from typing import List, Optional, Sequence
+from typing import Optional
 import sys
 from uuid import uuid4
 
@@ -25,13 +25,10 @@
 from google.ads.googleads.v20.services.types.asset_service import AssetOperation
 from google.ads.googleads.v20.resources.types.asset import Asset
 from google.ads.googleads.v20.common.types.asset_types import PriceAsset
-from google.ads.googleads.v20.enums.types.price_extension_type import PriceExtensionTypeEnum
-from google.ads.googleads.v20.enums.types.price_extension_price_qualifier import PriceExtensionPriceQualifierEnum
 from google.ads.googleads.v20.common.types.asset_types import PriceOffering
 from google.ads.googleads.v20.enums.types.price_extension_price_unit import PriceExtensionPriceUnitEnum
 from google.ads.googleads.v20.services.types.customer_asset_service import CustomerAssetOperation
 from google.ads.googleads.v20.resources.types.customer_asset import CustomerAsset
-from google.ads.googleads.v20.enums.types.asset_field_type import AssetFieldTypeEnum
 
 
 def main(client: GoogleAdsClient, customer_id: str) -> None:
diff --git a/examples/assets/add_sitelinks.py b/examples/assets/add_sitelinks.py
@@ -18,18 +18,15 @@
 """
 
 import argparse
-from typing import List, Sequence
+from typing import List
 import sys
-import uuid
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.ads.googleads.v20.services.types.asset_service import AssetOperation
 from google.ads.googleads.v20.resources.types.asset import Asset
-from google.ads.googleads.v20.common.types.asset_types import SitelinkAsset
 from google.ads.googleads.v20.services.types.campaign_asset_service import CampaignAssetOperation
 from google.ads.googleads.v20.resources.types.campaign_asset import CampaignAsset
-from google.ads.googleads.v20.enums.types.asset_field_type import AssetFieldTypeEnum
 
 
 def main(
diff --git a/examples/assets/upload_image_asset.py b/examples/assets/upload_image_asset.py
@@ -19,16 +19,13 @@
 
 
 import argparse
-from typing import Sequence
 import sys
 
 from examples.utils.example_helpers import get_image_bytes_from_url
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.ads.googleads.v20.services.types.asset_service import AssetOperation
 from google.ads.googleads.v20.resources.types.asset import Asset
-from google.ads.googleads.v20.enums.types.asset_type import AssetTypeEnum
-from google.ads.googleads.v20.enums.types.mime_type import MimeTypeEnum
 
 
 # [START upload_image_asset]
diff --git a/examples/billing/get_invoices.py b/examples/billing/get_invoices.py
@@ -18,7 +18,7 @@
 import argparse
 from datetime import date, timedelta
 import sys
-from typing import Any, Optional
+from typing import Optional
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
diff --git a/examples/custom_logging_interceptor/cloud_logging_interceptor.py b/examples/custom_logging_interceptor/cloud_logging_interceptor.py
@@ -19,20 +19,13 @@
 within the class (in this case, a Cloud Logging client).
 """
 
-import logging
 import time
-from typing import Any, Callable, Dict, Optional, Tuple
+from typing import Any, Callable, Dict, Optional
 
 from google.cloud import logging as google_cloud_logging
-from grpc import (
-    Call,
-    Future,
-    UnaryUnaryClientInterceptor,
-    UnaryStreamClientInterceptor,
-)
 from grpc._interceptor import _ClientCallDetails
 
-from google.ads.googleads.interceptors import LoggingInterceptor, mask_message
+from google.ads.googleads.interceptors import LoggingInterceptor
 
 
 class CloudLoggingInterceptor(LoggingInterceptor):
diff --git a/examples/google-ads-account-analyzer-demo/analyzer.py b/examples/google-ads-account-analyzer-demo/analyzer.py
@@ -168,7 +168,7 @@ def get_users_module(google_ads_client: GoogleAdsClient, customer_id: Optional[s
     """
     googleads_service = google_ads_client.get_service("GoogleAdsService")
     customer_service = google_ads_client.get_service("CustomerService")
-    query = f"""
+    query = """
     SELECT
       customer_user_access.user_id,
       customer_user_access.email_address,
@@ -215,7 +215,7 @@ def get_users_module(google_ads_client: GoogleAdsClient, customer_id: Optional[s
             f'Request with ID "{ex.request_id}" failed with status '
             f'"{ex.error.code().name}" '
         )
-        print(f"And includes the following errors:")
+        print("And includes the following errors:")
         for error in ex.failure.errors:
             print(f'\tError with message "{error.message}".')
             if error.location:
diff --git a/examples/misc/set_custom_client_timeouts.py b/examples/misc/set_custom_client_timeouts.py
@@ -91,7 +91,7 @@ def make_server_streaming_call(
                 campaign_ids.append(row.campaign.id)
 
         print("The server streaming call completed before the timeout.")
-    except DeadlineExceeded as ex:
+    except DeadlineExceeded:
         print("The server streaming call did not complete before the timeout.")
         sys.exit(1)
     except GoogleAdsException as ex:
@@ -156,7 +156,7 @@ def make_unary_call(client: GoogleAdsClient, customer_id: str) -> None:
             campaign_ids.append(row.campaign.id)
 
         print("The unary call completed before the timeout.")
-    except DeadlineExceeded as ex:
+    except DeadlineExceeded:
         print("The unary call did not complete before the timeout.")
         sys.exit(1)
     except GoogleAdsException as ex:
diff --git a/examples/misc/upload_image_asset.py b/examples/misc/upload_image_asset.py
@@ -33,7 +33,6 @@
     MutateAssetResult,
     MutateAssetsResponse,
 )
-from examples.utils.example_helpers import get_image_bytes_from_url
 
 
 # [START upload_image_asset]
diff --git a/examples/planning/forecast_reach.py b/examples/planning/forecast_reach.py
diff --git a/examples/planning/generate_forecast_metrics.py b/examples/planning/generate_forecast_metrics.py
diff --git a/examples/planning/generate_historical_metrics.py b/examples/planning/generate_historical_metrics.py
diff --git a/examples/planning/generate_keyword_ideas.py b/examples/planning/generate_keyword_ideas.py
diff --git a/examples/planning/get_ad_group_criterion_cpc_bid_simulations.py b/examples/planning/get_ad_group_criterion_cpc_bid_simulations.py
diff --git a/examples/recommendations/detect_and_apply_recommendations.py b/examples/recommendations/detect_and_apply_recommendations.py
diff --git a/examples/remarketing/add_dynamic_remarketing_asset.py b/examples/remarketing/add_dynamic_remarketing_asset.py

Original file line number	Diff line number	Diff line change
`@@ -43,9 +43,6 @@`
`43`	`43`	`CustomerUserAccessOperation,`
`44`	`44`	`MutateCustomerUserAccessResponse,`
`45`	`45`	`)`
`46`		`-from google.ads.googleads.v20.enums.types.access_role import (`
`47`		`- AccessRoleEnum,`
`48`		`-) # For type of customer_user_access.access_role`
`49`	`46`
`50`	`47`	`from google.api_core import protobuf_helpers`
`51`	`48`	`from google.protobuf.field_mask_pb2 import FieldMask`