Add annotations to the google ads account analyzer example (#947)

Author: bobhancockg

examples/google-ads-account-analyzer-demo/analyzer.py

@@ -17,14 +17,15 @@
 
 import argparse
 import sys
+from typing import Optional, Dict, List, Any
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 
 _DEFAULT_LOG_SPACE_LENGTH = 4
 
 
-def account_hierarchy_module(google_ads_client, customer_id):
+def account_hierarchy_module(google_ads_client: GoogleAdsClient, customer_id: Optional[str]):
     """Print the account hierarchy for the given login customer ID.
 
     Args:
@@ -74,7 +75,7 @@ def account_hierarchy_module(google_ads_client, customer_id):
         # Performs a breadth-first search to build a Dictionary that maps
         # managers to their child accounts (customer_ids_to_child_accounts).
         unprocessed_customer_ids = [seed_customer_id]
-        customer_ids_to_child_accounts = dict()
+        customer_ids_to_child_accounts: Dict[str, List[Any]] = dict()
         root_customer_client = None
 
         while unprocessed_customer_ids:
@@ -129,7 +130,7 @@ def account_hierarchy_module(google_ads_client, customer_id):
 
 
 def print_account_hierarchy(
-    customer_client, customer_ids_to_child_accounts, depth
+    customer_client: Any, customer_ids_to_child_accounts: Dict[str, List[Any]], depth: int
 ):
     """Prints the specified account's hierarchy using recursion.
 
@@ -157,7 +158,7 @@ def print_account_hierarchy(
             )
 
 
-def get_users_module(google_ads_client, customer_id):
+def get_users_module(google_ads_client: GoogleAdsClient, customer_id: Optional[str]):
     """Prints the user access information for the given customer_id.
 
     Args:

examples/misc/add_ad_group_image_asset.py

@@ -50,8 +50,7 @@ def main(
 
     for result in response.results:
         print(
-            "Created ad group asset with resource name: "
-            f"'{result.resource_name}'"
+            f"Created ad group asset with resource name: '{result.resource_name}'"
         )
 
 

examples/misc/campaign_report_to_csv.py

@@ -28,8 +28,8 @@
 """
 import argparse
 import csv
-import sys
 import os
+import sys
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
@@ -119,26 +119,32 @@ def main(
         "--customer_id",
         type=str,
         required=True,
-        help="The Google Ads customer ID of the account you would like to get "
-        "the report for to write to CSV.",
+        help=(
+            "The Google Ads customer ID of the account you would like to get "
+            "the report for to write to CSV."
+        ),
     )
     parser.add_argument(
         "-o",
         "--output_file",
         type=str,
         required=False,
         default=_DEFAULT_FILE_NAME,
-        help="Name of the local CSV file to save the report to. File will be "
-        "saved in the same directory as the script.",
+        help=(
+            "Name of the local CSV file to save the report to. File will be "
+            "saved in the same directory as the script."
+        ),
     )
     # Optional boolean argument for writing headers.
     parser.add_argument(
         "-w",
         "--write_headers",
         action="store_true",
-        help="Writes headers to the CSV file if argument is supplied. Simply "
-        "add -w if you want the headers defined in the script to be "
-        "added as the first row in the CSV file.",
+        help=(
+            "Writes headers to the CSV file if argument is supplied. Simply "
+            "add -w if you want the headers defined in the script to be "
+            "added as the first row in the CSV file."
+        ),
     )
     args = parser.parse_args()
 

examples/misc/set_custom_client_timeouts.py

@@ -158,8 +158,10 @@ def make_unary_call(client: GoogleAdsClient, customer_id: str) -> None:
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(
-        description="Demonstrates custom client timeouts in the context of "
-        "server streaming and unary calls."
+        description=(
+            "Demonstrates custom client timeouts in the context of "
+            "server streaming and unary calls."
+        )
     )
     # The following argument(s) should be provided to run the example.
     parser.add_argument(

examples/misc/upload_image_asset.py

@@ -21,6 +21,7 @@
 import argparse
 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.v19.services.types import (
@@ -54,10 +55,8 @@ def main(client: GoogleAdsClient, customer_id: str) -> None:
     # When there is an existing image asset with the same content but a different
     # name, the new name will be dropped silently.
     asset.name = "Marketing Image"
-    mutate_asset_response: MutateAssetsResponse = (
-        asset_service.mutate_assets(
-            customer_id=customer_id, operations=[asset_operation]
-        )
+    mutate_asset_response: MutateAssetsResponse = asset_service.mutate_assets(
+        customer_id=customer_id, operations=[asset_operation]
     )
     print("Uploaded file(s):")
     for row in mutate_asset_response.results: