Update annotations in advanced_operations examples.

Change-Id: Iaa2528d2f11a9ad01f07807daba6102fd7694828

Author: BenRKarl

examples/advanced_operations/add_ad_customizer.py

@@ -21,11 +21,36 @@
 
 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
+from google.ads.googleads.v21.common.types import AdTextAsset
+from google.ads.googleads.v21.resources.types import (
+    AdGroupAd,
+    AdGroupCustomizer,
+    CustomizerAttribute,
+)
+from google.ads.googleads.v21.services.services.ad_group_ad_service import (
+    AdGroupAdServiceClient,
+)
+from google.ads.googleads.v21.services.services.ad_group_customizer_service import (
+    AdGroupCustomizerServiceClient,
+)
+from google.ads.googleads.v21.services.services.customizer_attribute_service import (
+    CustomizerAttributeServiceClient,
+)
+from google.ads.googleads.v21.services.services.google_ads_service import (
+    GoogleAdsServiceClient,
+)
+from google.ads.googleads.v21.services.types import (
+    AdGroupAdOperation,
+    AdGroupCustomizerOperation,
+    CustomizerAttributeOperation,
+    MutateAdGroupAdsResponse,
+    MutateAdGroupCustomizersResponse,
+    MutateCustomizerAttributesResponse,
+)
 
 
 def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str) -> None:
@@ -75,19 +100,23 @@ def create_text_customizer_attribute(
     Returns:
         a resource name for a text customizer attribute.
     """
-    customizer_attribute_service: Any = client.get_service(
-        "CustomizerAttributeService"
+    customizer_attribute_service: CustomizerAttributeServiceClient = (
+        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: Any = client.get_type("CustomizerAttributeOperation")
-    text_attribute: Any = operation.create
+    operation: CustomizerAttributeOperation = client.get_type(
+        "CustomizerAttributeOperation"
+    )
+    text_attribute: CustomizerAttribute = operation.create
     text_attribute.name = customizer_name
     text_attribute.type_ = client.enums.CustomizerAttributeTypeEnum.TEXT
 
-    response: Any = customizer_attribute_service.mutate_customizer_attributes(
-        customer_id=customer_id, operations=[operation]
+    response: MutateCustomizerAttributesResponse = (
+        customizer_attribute_service.mutate_customizer_attributes(
+            customer_id=customer_id, operations=[operation]
+        )
     )
 
     resource_name: str = response.results[0].resource_name
@@ -112,19 +141,23 @@ def create_price_customizer_attribute(
     Returns:
         a resource name for a text customizer attribute.
     """
-    customizer_attribute_service: Any = client.get_service(
-        "CustomizerAttributeService"
+    customizer_attribute_service: CustomizerAttributeServiceClient = (
+        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: Any = client.get_type("CustomizerAttributeOperation")
-    price_attribute: Any = operation.create
+    operation: CustomizerAttributeOperation = client.get_type(
+        "CustomizerAttributeOperation"
+    )
+    price_attribute: CustomizerAttribute = operation.create
     price_attribute.name = customizer_name
     price_attribute.type_ = client.enums.CustomizerAttributeTypeEnum.PRICE
 
-    response: Any = customizer_attribute_service.mutate_customizer_attributes(
-        customer_id=customer_id, operations=[operation]
+    response: MutateCustomizerAttributesResponse = (
+        customizer_attribute_service.mutate_customizer_attributes(
+            customer_id=customer_id, operations=[operation]
+        )
     )
 
     resource_name: str = response.results[0].resource_name
@@ -155,15 +188,19 @@ 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: Any = client.get_service("GoogleAdsService")
-    ad_group_customizer_service: Any = client.get_service(
-        "AdGroupCustomizerService"
+    googleads_service: GoogleAdsServiceClient = client.get_service(
+        "GoogleAdsService"
+    )
+    ad_group_customizer_service: AdGroupCustomizerServiceClient = (
+        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: Any = client.get_type("AdGroupCustomizerOperation")
-    mars_customizer: Any = mars_operation.create
+    mars_operation: AdGroupCustomizerOperation = client.get_type(
+        "AdGroupCustomizerOperation"
+    )
+    mars_customizer: AdGroupCustomizer = 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"
@@ -173,8 +210,10 @@ 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: Any = client.get_type("AdGroupCustomizerOperation")
-    price_customizer: Any = price_operation.create
+    price_operation: AdGroupCustomizerOperation = client.get_type(
+        "AdGroupCustomizerOperation"
+    )
+    price_customizer: AdGroupCustomizer = price_operation.create
     price_customizer.customizer_attribute = price_customizer_resource_name
     price_customizer.value.type_ = (
         client.enums.CustomizerAttributeTypeEnum.PRICE
@@ -184,8 +223,11 @@ def link_customizer_attributes(
         customer_id, ad_group_id
     )
 
-    response: Any = ad_group_customizer_service.mutate_ad_group_customizers(
-        customer_id=customer_id, operations=[mars_operation, price_operation]
+    response: MutateAdGroupCustomizersResponse = (
+        ad_group_customizer_service.mutate_ad_group_customizers(
+            customer_id=customer_id,
+            operations=[mars_operation, price_operation],
+        )
     )
 
     for result in response.results:
@@ -215,41 +257,45 @@ def create_ad_with_customizations(
         text_customizer_name: name of the text customizer.
         price_customizer_name: name of the price customizer.
     """
-    googleads_service: Any = client.get_service("GoogleAdsService")
-    ad_group_ad_service: Any = client.get_service("AdGroupAdService")
+    googleads_service: GoogleAdsServiceClient = client.get_service(
+        "GoogleAdsService"
+    )
+    ad_group_ad_service: AdGroupAdServiceClient = 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: Any = client.get_type("AdGroupAdOperation")
-    ad_group_ad: Any = operation.create
+    operation: AdGroupAdOperation = client.get_type("AdGroupAdOperation")
+    ad_group_ad: AdGroupAd = 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: Any = client.get_type("AdTextAsset")
+    headline_1: AdTextAsset = 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: Any = client.get_type("AdTextAsset")
+    headline_2: AdTextAsset = client.get_type("AdTextAsset")
     headline_2.text = f"Only {{CUSTOMIZER.{price_customizer_name}:10.0€}}"
 
-    headline_3: Any = client.get_type("AdTextAsset")
+    headline_3: AdTextAsset = 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: Any = client.get_type("AdTextAsset")
+    description_1: AdTextAsset = client.get_type("AdTextAsset")
     description_1.text = (
         f"Tickets are only {{CUSTOMIZER.{price_customizer_name}:10.0€}}!"
     )
 
-    description_2: Any = client.get_type("AdTextAsset")
+    description_2: AdTextAsset = client.get_type("AdTextAsset")
     description_2.text = (
         f"Buy your tickets to {{CUSTOMIZER.{text_customizer_name}:Venus}} now!"
     )
@@ -258,8 +304,10 @@ def create_ad_with_customizations(
         [description_1, description_2]
     )
 
-    response: Any = ad_group_ad_service.mutate_ad_group_ads(
-        customer_id=customer_id, operations=[operation]
+    response: MutateAdGroupAdsResponse = (
+        ad_group_ad_service.mutate_ad_group_ads(
+            customer_id=customer_id, operations=[operation]
+        )
     )
     resource_name: str = response.results[0].resource_name
     print(f"Added an ad with resource name '{resource_name}'")
@@ -293,17 +341,9 @@ def create_ad_with_customizations(
 
     # 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"
+        version="v21"
     )
->>>>>>> 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,10 +20,23 @@
 
 import argparse
 import sys
-from typing import Any
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
+from google.ads.googleads.v21.enums.types.device import DeviceEnum
+from google.ads.googleads.v21.resources.types.ad_group_bid_modifier import (
+    AdGroupBidModifier,
+)
+from google.ads.googleads.v21.services.services.ad_group_bid_modifier_service import (
+    AdGroupBidModifierServiceClient,
+)
+from google.ads.googleads.v21.services.services.ad_group_service import (
+    AdGroupServiceClient,
+)
+from google.ads.googleads.v21.services.types.ad_group_bid_modifier_service import (
+    AdGroupBidModifierOperation,
+    MutateAdGroupBidModifiersResponse,
+)
 
 
 # [START add_ad_group_bid_modifier]
@@ -33,15 +46,21 @@ def main(
     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")
+    ad_group_service: AdGroupServiceClient = client.get_service(
+        "AdGroupService"
+    )
+    ad_group_bm_service: AdGroupBidModifierServiceClient = 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: Any = client.get_type(
-        "AdGroupBidModifierOperation"
+    ad_group_bid_modifier_operation: AdGroupBidModifierOperation = (
+        client.get_type("AdGroupBidModifierOperation")
+    )
+    ad_group_bid_modifier: AdGroupBidModifier = (
+        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(
@@ -52,11 +71,11 @@ def main(
     ad_group_bid_modifier.bid_modifier = bid_modifier_value
 
     # Sets the device.
-    device_enum: Any = client.enums.DeviceEnum
+    device_enum: DeviceEnum = client.enums.DeviceEnum
     ad_group_bid_modifier.device.type_ = device_enum.MOBILE
 
     # Add the ad group bid modifier.
-    ad_group_bm_response: Any = (
+    ad_group_bm_response: MutateAdGroupBidModifiersResponse = (
         ad_group_bm_service.mutate_ad_group_bid_modifiers(
             customer_id=customer_id,
             operations=[ad_group_bid_modifier_operation],