Add type hints to files in examples/advanced_operations

This commit introduces type hints to several files within the
examples/advanced_operations directory for Google Ads API v19.

The following files have been updated:
- examples/advanced_operations/add_ad_customizer.py
- examples/advanced_operations/add_ad_group_bid_modifier.py
- examples/advanced_operations/add_app_campaign.py
- examples/advanced_operations/add_bidding_data_exclusion.py
- examples/advanced_operations/add_bidding_seasonality_adjustment.py
- examples/advanced_operations/add_call_ad.py
- examples/advanced_operations/add_demand_gen_campaign.py
- examples/advanced_operations/add_display_upload_ad.py

Changes include adding type hints for function arguments, return
values, and relevant local variables. Necessary types were imported
from the `typing` module and `google.ads.googleads.client`.

In `add_display_upload_ad.py`, an `argparse` type for `ad_group_id`
was corrected from `int` to `str` to match its usage.

Author: google-labs-jules[bot]

examples/advanced_operations/add_ad_customizer.py

@@ -21,27 +21,28 @@
 
 import argparse
 import sys
+from typing import Any
 from uuid import uuid4
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 
 
-def main(client, customer_id, ad_group_id):
+def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str) -> None:
     """The main method that creates all necessary entities for the example.
 
     Args:
         client: an initialized GoogleAdsClient instance.
         customer_id: a client customer ID.
         ad_group_id: an ad group ID.
     """
-    text_customizer_name = f"Planet_{uuid4().hex[:8]}"
-    price_customizer_name = f"Price_{uuid4().hex[:8]}"
+    text_customizer_name: str = f"Planet_{uuid4().hex[:8]}"
+    price_customizer_name: str = f"Price_{uuid4().hex[:8]}"
 
-    text_customizer_resource_name = create_text_customizer_attribute(
+    text_customizer_resource_name: str = create_text_customizer_attribute(
         client, customer_id, text_customizer_name
     )
-    price_customizer_resource_name = create_price_customizer_attribute(
+    price_customizer_resource_name: str = create_price_customizer_attribute(
         client, customer_id, price_customizer_name
     )
     link_customizer_attributes(
@@ -61,7 +62,9 @@ def main(client, customer_id, ad_group_id):
 
 
 # [START add_ad_customizer]
-def create_text_customizer_attribute(client, customer_id, customizer_name):
+def create_text_customizer_attribute(
+    client: GoogleAdsClient, customer_id: str, customizer_name: str
+) -> str:
     """Creates a text customizer attribute and returns its resource name.
 
     Args:
@@ -72,22 +75,22 @@ def create_text_customizer_attribute(client, customer_id, customizer_name):
     Returns:
         a resource name for a text customizer attribute.
     """
-    customizer_attribute_service = client.get_service(
+    customizer_attribute_service: Any = client.get_service(
         "CustomizerAttributeService"
     )
 
     # Creates a text customizer attribute. The customizer attribute name is
     # arbitrary and will be used as a placeholder in the ad text fields.
-    operation = client.get_type("CustomizerAttributeOperation")
-    text_attribute = operation.create
+    operation: Any = client.get_type("CustomizerAttributeOperation")
+    text_attribute: Any = operation.create
     text_attribute.name = customizer_name
     text_attribute.type_ = client.enums.CustomizerAttributeTypeEnum.TEXT
 
-    response = customizer_attribute_service.mutate_customizer_attributes(
+    response: Any = customizer_attribute_service.mutate_customizer_attributes(
         customer_id=customer_id, operations=[operation]
     )
 
-    resource_name = response.results[0].resource_name
+    resource_name: str = response.results[0].resource_name
     print(
         f"Added text customizer attribute with resource name '{resource_name}'"
     )
@@ -96,7 +99,9 @@ def create_text_customizer_attribute(client, customer_id, customizer_name):
 
 
 # [START add_ad_customizer_1]
-def create_price_customizer_attribute(client, customer_id, customizer_name):
+def create_price_customizer_attribute(
+    client: GoogleAdsClient, customer_id: str, customizer_name: str
+) -> str:
     """Creates a price customizer attribute and returns its resource name.
 
     Args:
@@ -107,22 +112,22 @@ def create_price_customizer_attribute(client, customer_id, customizer_name):
     Returns:
         a resource name for a text customizer attribute.
     """
-    customizer_attribute_service = client.get_service(
+    customizer_attribute_service: Any = client.get_service(
         "CustomizerAttributeService"
     )
 
     # Creates a price customizer attribute. The customizer attribute name is
     # arbitrary and will be used as a placeholder in the ad text fields.
-    operation = client.get_type("CustomizerAttributeOperation")
-    price_attribute = operation.create
+    operation: Any = client.get_type("CustomizerAttributeOperation")
+    price_attribute: Any = operation.create
     price_attribute.name = customizer_name
     price_attribute.type_ = client.enums.CustomizerAttributeTypeEnum.PRICE
 
-    response = customizer_attribute_service.mutate_customizer_attributes(
+    response: Any = customizer_attribute_service.mutate_customizer_attributes(
         customer_id=customer_id, operations=[operation]
     )
 
-    resource_name = response.results[0].resource_name
+    resource_name: str = response.results[0].resource_name
     print(
         f"Added price customizer attribute with resource name '{resource_name}'"
     )
@@ -132,12 +137,12 @@ def create_price_customizer_attribute(client, customer_id, customizer_name):
 
 # [START add_ad_customizer_2]
 def link_customizer_attributes(
-    client,
-    customer_id,
-    ad_group_id,
-    text_customizer_resource_name,
-    price_customizer_resource_name,
-):
+    client: GoogleAdsClient,
+    customer_id: str,
+    ad_group_id: str,
+    text_customizer_resource_name: str,
+    price_customizer_resource_name: str,
+) -> None:
     """Restricts the ad customizer attributes to work with a specific ad group.
 
     This prevents the customizer attributes from being used elsewhere and makes
@@ -150,13 +155,15 @@ def link_customizer_attributes(
         text_customizer_resource_name: the resource name of the text customizer attribute.
         price_customizer_resource_name: the resource name of the price customizer attribute.
     """
-    googleads_service = client.get_service("GoogleAdsService")
-    ad_group_customizer_service = client.get_service("AdGroupCustomizerService")
+    googleads_service: Any = client.get_service("GoogleAdsService")
+    ad_group_customizer_service: Any = client.get_service(
+        "AdGroupCustomizerService"
+    )
 
     # Binds the text attribute customizer to a specific ad group to make sure
     # it will only be used to customize ads inside that ad group.
-    mars_operation = client.get_type("AdGroupCustomizerOperation")
-    mars_customizer = mars_operation.create
+    mars_operation: Any = client.get_type("AdGroupCustomizerOperation")
+    mars_customizer: Any = mars_operation.create
     mars_customizer.customizer_attribute = text_customizer_resource_name
     mars_customizer.value.type_ = client.enums.CustomizerAttributeTypeEnum.TEXT
     mars_customizer.value.string_value = "Mars"
@@ -166,8 +173,8 @@ def link_customizer_attributes(
 
     # Binds the price attribute customizer to a specific ad group to make sure
     # it will only be used to customize ads inside that ad group.
-    price_operation = client.get_type("AdGroupCustomizerOperation")
-    price_customizer = price_operation.create
+    price_operation: Any = client.get_type("AdGroupCustomizerOperation")
+    price_customizer: Any = price_operation.create
     price_customizer.customizer_attribute = price_customizer_resource_name
     price_customizer.value.type_ = (
         client.enums.CustomizerAttributeTypeEnum.PRICE
@@ -177,7 +184,7 @@ def link_customizer_attributes(
         customer_id, ad_group_id
     )
 
-    response = ad_group_customizer_service.mutate_ad_group_customizers(
+    response: Any = ad_group_customizer_service.mutate_ad_group_customizers(
         customer_id=customer_id, operations=[mars_operation, price_operation]
     )
 
@@ -191,12 +198,12 @@ def link_customizer_attributes(
 
 # [START add_ad_customizer_3]
 def create_ad_with_customizations(
-    client,
-    customer_id,
-    ad_group_id,
-    text_customizer_name,
-    price_customizer_name,
-):
+    client: GoogleAdsClient,
+    customer_id: str,
+    ad_group_id: str,
+    text_customizer_name: str,
+    price_customizer_name: str,
+) -> None:
     """Creates a responsive search ad (RSA).
 
     The RSA uses the ad customizer attributes to populate the placeholders.
@@ -208,41 +215,41 @@ def create_ad_with_customizations(
         text_customizer_name: name of the text customizer.
         price_customizer_name: name of the price customizer.
     """
-    googleads_service = client.get_service("GoogleAdsService")
-    ad_group_ad_service = client.get_service("AdGroupAdService")
+    googleads_service: Any = client.get_service("GoogleAdsService")
+    ad_group_ad_service: Any = client.get_service("AdGroupAdService")
 
     # Creates a responsive search ad using the attribute customizer names as
     # placeholders and default values to be used in case there are no attribute
     # customizer values.
-    operation = client.get_type("AdGroupAdOperation")
-    ad_group_ad = operation.create
+    operation: Any = client.get_type("AdGroupAdOperation")
+    ad_group_ad: Any = operation.create
     ad_group_ad.ad.final_urls.append("https://www.example.com")
     ad_group_ad.ad_group = googleads_service.ad_group_path(
         customer_id, ad_group_id
     )
 
-    headline_1 = client.get_type("AdTextAsset")
+    headline_1: Any = client.get_type("AdTextAsset")
     headline_1.text = (
         f"Luxury cruise to {{CUSTOMIZER.{text_customizer_name}:Venus}}"
     )
     headline_1.pinned_field = client.enums.ServedAssetFieldTypeEnum.HEADLINE_1
 
-    headline_2 = client.get_type("AdTextAsset")
+    headline_2: Any = client.get_type("AdTextAsset")
     headline_2.text = f"Only {{CUSTOMIZER.{price_customizer_name}:10.0€}}"
 
-    headline_3 = client.get_type("AdTextAsset")
+    headline_3: Any = client.get_type("AdTextAsset")
     headline_3.text = f"Cruise to {{CUSTOMIZER.{text_customizer_name}:Venus}} for {{CUSTOMIZER.{price_customizer_name}:10.0€}}"
 
     ad_group_ad.ad.responsive_search_ad.headlines.extend(
         [headline_1, headline_2, headline_3]
     )
 
-    description_1 = client.get_type("AdTextAsset")
+    description_1: Any = client.get_type("AdTextAsset")
     description_1.text = (
         f"Tickets are only {{CUSTOMIZER.{price_customizer_name}:10.0€}}!"
     )
 
-    description_2 = client.get_type("AdTextAsset")
+    description_2: Any = client.get_type("AdTextAsset")
     description_2.text = (
         f"Buy your tickets to {{CUSTOMIZER.{text_customizer_name}:Venus}} now!"
     )
@@ -251,10 +258,10 @@ def create_ad_with_customizations(
         [description_1, description_2]
     )
 
-    response = ad_group_ad_service.mutate_ad_group_ads(
+    response: Any = ad_group_ad_service.mutate_ad_group_ads(
         customer_id=customer_id, operations=[operation]
     )
-    resource_name = response.results[0].resource_name
+    resource_name: str = response.results[0].resource_name
     print(f"Added an ad with resource name '{resource_name}'")
     # [END add_ad_customizer_3]
 
@@ -282,11 +289,21 @@ def create_ad_with_customizations(
         required=True,
         help="An ad group ID.",
     )
-    args = parser.parse_args()
+    args: argparse.Namespace = parser.parse_args()
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
+<<<<<<< HEAD
     googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+=======
+<<<<<<< HEAD
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+=======
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(
+        version="v19"
+    )
+>>>>>>> 83bf66141 (Add type hints to files in examples/advanced_operations)
+>>>>>>> f8ca36136 (Add type hints to files in examples/advanced_operations)
 
     try:
         main(googleads_client, args.customer_id, args.ad_group_id)

examples/advanced_operations/add_ad_group_bid_modifier.py

@@ -20,22 +20,28 @@
 
 import argparse
 import sys
+from typing import Any
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 
 
 # [START add_ad_group_bid_modifier]
-def main(client, customer_id, ad_group_id, bid_modifier_value):
-    ad_group_service = client.get_service("AdGroupService")
-    ad_group_bm_service = client.get_service("AdGroupBidModifierService")
+def main(
+    client: GoogleAdsClient,
+    customer_id: str,
+    ad_group_id: str,
+    bid_modifier_value: float,
+) -> None:
+    ad_group_service: Any = client.get_service("AdGroupService")
+    ad_group_bm_service: Any = client.get_service("AdGroupBidModifierService")
 
     # Create ad group bid modifier for mobile devices with the specified ad
     # group ID and bid modifier value.
-    ad_group_bid_modifier_operation = client.get_type(
+    ad_group_bid_modifier_operation: Any = client.get_type(
         "AdGroupBidModifierOperation"
     )
-    ad_group_bid_modifier = ad_group_bid_modifier_operation.create
+    ad_group_bid_modifier: Any = ad_group_bid_modifier_operation.create
 
     # Set the ad group.
     ad_group_bid_modifier.ad_group = ad_group_service.ad_group_path(
@@ -46,13 +52,15 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
     ad_group_bid_modifier.bid_modifier = bid_modifier_value
 
     # Sets the device.
-    device_enum = client.enums.DeviceEnum
+    device_enum: Any = client.enums.DeviceEnum
     ad_group_bid_modifier.device.type_ = device_enum.MOBILE
 
     # Add the ad group bid modifier.
-    ad_group_bm_response = ad_group_bm_service.mutate_ad_group_bid_modifiers(
-        customer_id=customer_id,
-        operations=[ad_group_bid_modifier_operation],
+    ad_group_bm_response: Any = (
+        ad_group_bm_service.mutate_ad_group_bid_modifiers(
+            customer_id=customer_id,
+            operations=[ad_group_bid_modifier_operation],
+        )
     )
     # [END add_ad_group_bid_modifier]
 
@@ -88,11 +96,15 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
         default=1.5,
         help="The bid modifier value.",
     )
-    args = parser.parse_args()
+    args: argparse.Namespace = parser.parse_args()
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    # 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="v21"
+    )
 
     try:
         main(