This change adds Python type hints and annotations to the

scripts in the examples/travel directory.

Type hints were added to function arguments, return values,
and variables where appropriate to improve code readability
and maintainability.

The `typing.Any` type was used for Google Ads API objects
where specific types were not readily available.
All changes are compatible with Python 3.8+.

Author: google-labs-jules[bot]

examples/travel/add_hotel_ad.py

@@ -24,62 +24,72 @@
 import argparse
 import sys
 import uuid
+from typing import Any
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 
 
 def main(
-    client, customer_id, hotel_center_account_id, cpc_bid_ceiling_micro_amount
-):
-    budget_resource_name = add_budget(client, customer_id)
-
-    campaign_resource_name = add_hotel_campaign(
+    client: GoogleAdsClient,
+    customer_id: str,
+    hotel_center_account_id: int,
+    cpc_bid_ceiling_micro_amount: int,
+) -> None:
+    budget_resource_name: str = add_budget(client, customer_id)
+
+    campaign_resource_name: str = add_hotel_campaign(
         client,
         customer_id,
         budget_resource_name,
         hotel_center_account_id,
         cpc_bid_ceiling_micro_amount,
     )
 
-    ad_group_resource_name = add_hotel_ad_group(
+    ad_group_resource_name: str = add_hotel_ad_group(
         client, customer_id, campaign_resource_name
     )
 
     add_hotel_ad(client, customer_id, ad_group_resource_name)
 
 
-def add_budget(client, customer_id):
-    campaign_budget_service = client.get_service("CampaignBudgetService")
+def add_budget(client: GoogleAdsClient, customer_id: str) -> str:
+    campaign_budget_service: Any = client.get_service("CampaignBudgetService")
 
     # Create a budget, which can be shared by multiple campaigns.
-    campaign_budget_operation = client.get_type("CampaignBudgetOperation")
-    campaign_budget = campaign_budget_operation.create
+    campaign_budget_operation: Any = client.get_type("CampaignBudgetOperation")
+    campaign_budget: Any = campaign_budget_operation.create
     campaign_budget.name = f"Interplanetary Budget {uuid.uuid4()}"
     campaign_budget.delivery_method = (
         client.enums.BudgetDeliveryMethodEnum.STANDARD
     )
     campaign_budget.amount_micros = 500000
 
     # Add budget.
-    campaign_budget_response = campaign_budget_service.mutate_campaign_budgets(
-        customer_id=customer_id, operations=[campaign_budget_operation]
+    campaign_budget_response: Any = (
+        campaign_budget_service.mutate_campaign_budgets(
+            customer_id=customer_id, operations=[campaign_budget_operation]
+        )
     )
 
-    budget_resource_name = campaign_budget_response.results[0].resource_name
+    budget_resource_name: str = campaign_budget_response.results[
+        0
+    ].resource_name
 
     print(f"Created budget with resource name '{budget_resource_name}'.")
 
     return budget_resource_name
 
 
 # [START add_hotel_ad_3]
-def add_hotel_ad(client, customer_id, ad_group_resource_name):
-    ad_group_ad_service = client.get_service("AdGroupAdService")
+def add_hotel_ad(
+    client: GoogleAdsClient, customer_id: str, ad_group_resource_name: str
+) -> str:
+    ad_group_ad_service: Any = client.get_service("AdGroupAdService")
 
     # Creates a new ad group ad and sets the hotel ad to it.
-    ad_group_ad_operation = client.get_type("AdGroupAdOperation")
-    ad_group_ad = ad_group_ad_operation.create
+    ad_group_ad_operation: Any = client.get_type("AdGroupAdOperation")
+    ad_group_ad: Any = ad_group_ad_operation.create
     ad_group_ad.ad_group = ad_group_resource_name
     # Set the ad group ad to enabled.  Setting this to paused will cause an error
     # for hotel campaigns.  For hotels pausing should happen at either the ad group or
@@ -88,11 +98,13 @@ def add_hotel_ad(client, customer_id, ad_group_resource_name):
     client.copy_from(ad_group_ad.ad.hotel_ad, client.get_type("HotelAdInfo"))
 
     # Add the ad group ad.
-    ad_group_ad_response = ad_group_ad_service.mutate_ad_group_ads(
+    ad_group_ad_response: Any = ad_group_ad_service.mutate_ad_group_ads(
         customer_id=customer_id, operations=[ad_group_ad_operation]
     )
 
-    ad_group_ad_resource_name = ad_group_ad_response.results[0].resource_name
+    ad_group_ad_resource_name: str = ad_group_ad_response.results[
+        0
+    ].resource_name
 
     print(f"Created hotel ad with resource name '{ad_group_ad_resource_name}'.")
 
@@ -101,12 +113,14 @@ def add_hotel_ad(client, customer_id, ad_group_resource_name):
 
 
 # [START add_hotel_ad_2]
-def add_hotel_ad_group(client, customer_id, campaign_resource_name):
-    ad_group_service = client.get_service("AdGroupService")
+def add_hotel_ad_group(
+    client: GoogleAdsClient, customer_id: str, campaign_resource_name: str
+) -> str:
+    ad_group_service: Any = client.get_service("AdGroupService")
 
     # Create ad group.
-    ad_group_operation = client.get_type("AdGroupOperation")
-    ad_group = ad_group_operation.create
+    ad_group_operation: Any = client.get_type("AdGroupOperation")
+    ad_group: Any = ad_group_operation.create
     ad_group.name = f"Earth to Mars cruise {uuid.uuid4()}"
     ad_group.status = client.enums.AdGroupStatusEnum.ENABLED
     ad_group.campaign = campaign_resource_name
@@ -115,11 +129,11 @@ def add_hotel_ad_group(client, customer_id, campaign_resource_name):
     ad_group.cpc_bid_micros = 10000000
 
     # Add the ad group.
-    ad_group_response = ad_group_service.mutate_ad_groups(
+    ad_group_response: Any = ad_group_service.mutate_ad_groups(
         customer_id=customer_id, operations=[ad_group_operation]
     )
 
-    ad_group_resource_name = ad_group_response.results[0].resource_name
+    ad_group_resource_name: str = ad_group_response.results[0].resource_name
 
     print(
         "Added a hotel ad group with resource name '{ad_group_resource_name}'."
@@ -131,18 +145,18 @@ def add_hotel_ad_group(client, customer_id, campaign_resource_name):
 
 # [START add_hotel_ad]
 def add_hotel_campaign(
-    client,
-    customer_id,
-    budget_resource_name,
-    hotel_center_account_id,
-    cpc_bid_ceiling_micro_amount,
-):
-    campaign_service = client.get_service("CampaignService")
+    client: GoogleAdsClient,
+    customer_id: str,
+    budget_resource_name: str,
+    hotel_center_account_id: int,
+    cpc_bid_ceiling_micro_amount: int,
+) -> str:
+    campaign_service: Any = client.get_service("CampaignService")
 
     # [START add_hotel_ad_1]
     # Create campaign.
-    campaign_operation = client.get_type("CampaignOperation")
-    campaign = campaign_operation.create
+    campaign_operation: Any = client.get_type("CampaignOperation")
+    campaign: Any = campaign_operation.create
     campaign.name = f"Interplanetary Cruise Campaign {uuid.uuid4()}"
 
     # Configures settings related to hotel campaigns including advertising
@@ -170,11 +184,11 @@ def add_hotel_campaign(
     # [END add_hotel_ad_1]
 
     # Add the campaign.
-    campaign_response = campaign_service.mutate_campaigns(
+    campaign_response: Any = campaign_service.mutate_campaigns(
         customer_id=customer_id, operations=[campaign_operation]
     )
 
-    campaign_resource_name = campaign_response.results[0].resource_name
+    campaign_resource_name: str = campaign_response.results[0].resource_name
 
     print(
         "Added a hotel campaign with resource name '{campaign_resource_name}'."
@@ -185,7 +199,7 @@ def add_hotel_campaign(
 
 
 if __name__ == "__main__":
-    parser = argparse.ArgumentParser(
+    parser: argparse.ArgumentParser = argparse.ArgumentParser(
         description=(
             "Adds an expanded text ad to the specified ad group ID, "
             "for the given customer ID."
@@ -213,11 +227,13 @@ def add_hotel_campaign(
         required=True,
         help="The hotel center account 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.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(
+        version="v20"
+    )
 
     try:
         main(

examples/travel/add_hotel_ad_group_bid_modifiers.py

@@ -20,19 +20,22 @@
 
 import argparse
 import sys
+from typing import Any
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 
 
 # [START add_hotel_ad_group_bid_modifiers]
-def main(client, customer_id, ad_group_id):
-    ad_group_service = client.get_service("AdGroupService")
-    ag_bm_service = client.get_service("AdGroupBidModifierService")
+def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str) -> None:
+    ad_group_service: Any = client.get_service("AdGroupService")
+    ag_bm_service: Any = client.get_service("AdGroupBidModifierService")
 
     # Create ad group bid modifier based on hotel check-in day.
-    check_in_ag_bm_operation = client.get_type("AdGroupBidModifierOperation")
-    check_in_ag_bid_modifier = check_in_ag_bm_operation.create
+    check_in_ag_bm_operation: Any = client.get_type(
+        "AdGroupBidModifierOperation"
+    )
+    check_in_ag_bid_modifier: Any = check_in_ag_bm_operation.create
     check_in_ag_bid_modifier.hotel_check_in_day.day_of_week = (
         client.enums.DayOfWeekEnum.MONDAY
     )
@@ -43,20 +46,22 @@ def main(client, customer_id, ad_group_id):
     check_in_ag_bid_modifier.bid_modifier = 1.5
 
     # Create ad group bid modifier based on hotel length of stay info.
-    los_ag_bm_operation = client.get_type("AdGroupBidModifierOperation")
-    los_ag_bid_modifier = los_ag_bm_operation.create
+    los_ag_bm_operation: Any = client.get_type("AdGroupBidModifierOperation")
+    los_ag_bid_modifier: Any = los_ag_bm_operation.create
     los_ag_bid_modifier.ad_group = ad_group_service.ad_group_path(
         customer_id, ad_group_id
     )
     # Creates the hotel length of stay info.
-    hotel_length_of_stay_info = los_ag_bid_modifier.hotel_length_of_stay
+    hotel_length_of_stay_info: Any = (
+        los_ag_bid_modifier.hotel_length_of_stay
+    )
     hotel_length_of_stay_info.min_nights = 3
     hotel_length_of_stay_info.max_nights = 7
     # Sets the bid modifier value to 170%.
     los_ag_bid_modifier.bid_modifier = 1.7
 
     # Add the bid modifiers
-    ag_bm_response = ag_bm_service.mutate_ad_group_bid_modifiers(
+    ag_bm_response: Any = ag_bm_service.mutate_ad_group_bid_modifiers(
         customer_id=customer_id,
         operations=[check_in_ag_bm_operation, los_ag_bm_operation],
     )
@@ -70,7 +75,7 @@ def main(client, customer_id, ad_group_id):
 
 
 if __name__ == "__main__":
-    parser = argparse.ArgumentParser(
+    parser: argparse.ArgumentParser = argparse.ArgumentParser(
         description=("Adds an ad group bid modifier to a hotel ad group.")
     )
     # The following argument(s) should be provided to run the example.
@@ -88,11 +93,13 @@ def main(client, customer_id, ad_group_id):
         required=True,
         help="The ad group ID of the hotel ad group.",
     )
-    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="v20")
+    googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(
+        version="v20"
+    )
 
     try:
         main(googleads_client, args.customer_id, args.ad_group_id)