Release v2.1.1

Author: bobhancockg

ChangeLog

@@ -1,3 +1,6 @@
+* 2.1.1
+- api_examples: api version is a required argument with no default value.
+
 * 2.1.0
 - Updated Workflow: API Versioning & Pre-Task Validation
 - Added anti-pattern to Configuration Protocol

api_examples/add_campaign_with_date_times.py

@@ -124,10 +124,6 @@ def _handle_google_ads_exception(exception):
 
 
 if __name__ == "__main__":
-    # GoogleAdsClient will read the google-ads.yaml configuration file in the
-    # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
-
     parser = argparse.ArgumentParser(
         description="Creates a campaign with start and end date times."
     )
@@ -139,6 +135,17 @@ def _handle_google_ads_exception(exception):
         required=True,
         help="The Google Ads customer ID.",
     )
+    parser.add_argument(
+        "-v",
+        "--api_version",
+        type=str,
+        required=True,
+        help="The Google Ads API version.",
+    )
     args = 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=args.api_version)
+
     main(googleads_client, args.customer_id)

api_examples/ai_max_reports.py

@@ -65,7 +65,7 @@ def main(client: GoogleAdsClient, customer_id: str, report_type: str) -> None:
         help="The type of AI Max report to generate.",
     )
     parser.add_argument(
-        "-v", "--api_version", type=str, default="v23", help="The Google Ads API version."
+        "-v", "--api_version", type=str, required=True, help="The Google Ads API version."
     )
     args = parser.parse_args()
     client = GoogleAdsClient.load_from_storage(version=args.api_version)

api_examples/capture_gclids.py

@@ -83,7 +83,7 @@ def main(
         help="The GCLID for the ad click.",
     )
     parser.add_argument(
-        "-v", "--api_version", type=str, default="v23", help="The Google Ads API version."
+        "-v", "--api_version", type=str, required=True, help="The Google Ads API version."
     )
     args = parser.parse_args()
 

api_examples/collect_conversions_troubleshooting_data.py

@@ -112,7 +112,7 @@ def main(client: GoogleAdsClient, customer_id: str):
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser()
-    parser.add_argument("-v", "--api_version", type=str, default="v23", help="The Google Ads API version.")
+    parser.add_argument("-v", "--api_version", type=str, required=True, help="The Google Ads API version.")
     args = parser.parse_args()
     googleads_client = GoogleAdsClient.load_from_storage(version=args.api_version)
     main(googleads_client, args.customer_id)

api_examples/conversion_reports.py

@@ -212,7 +212,7 @@ def get_conversion_performance_report(
     parser.add_argument("--date_range_preset", default="LAST_30_DAYS")
     parser.add_argument("--metrics", nargs="+", default=["conversions"])
     parser.add_argument("--filters", nargs="*", default=[])
-    parser.add_argument("-v", "--api_version", type=str, default="v23", help="The Google Ads API version.")
+    parser.add_argument("-v", "--api_version", type=str, required=True, help="The Google Ads API version.")
 
     args = parser.parse_args()
     googleads_client = GoogleAdsClient.load_from_storage(version=args.api_version)

api_examples/create_campaign_experiment.py

@@ -221,7 +221,7 @@ def modify_treatment_campaign(client, customer_id, draft_campaign_resource_name)
         help="The ID of the base campaign to use for the experiment.",
     )
     parser.add_argument(
-        "-v", "--api_version", type=str, default="v23", help="The Google Ads API version."
+        "-v", "--api_version", type=str, required=True, help="The Google Ads API version."
     )
     args = parser.parse_args()
 

api_examples/disapproved_ads_reports.py

@@ -37,8 +37,9 @@ def main(client: GoogleAdsClient, customer_id: str, output_file: str) -> None:
     parser.add_argument("-c", "--customer_id", required=True)
     parser.add_argument("-o", "--output", default="saved_csv/disapproved_ads.csv")
     parser.add_argument(
-        "-v", "--api_version", type=str, default="v23", help="The Google Ads API version."
+        "-v", "--api_version", type=str, required=True, help="The Google Ads API version."
     )
     args = parser.parse_args()
+    client = GoogleAdsClient.load_from_storage(version=args.api_version)
     main(client, args.customer_id, args.output)
 

api_examples/gaql_validator.py

@@ -53,8 +53,8 @@ def main(
         )
         parser.add_argument(
             "--api_version",
-            default="v23",
-            help="API Version (e.g., v23). Defaults to v23.",
+            required=True,
+            help="API Version (e.g., v23).",
         )
         args = parser.parse_args()
 

api_examples/get_campaign_bid_simulations.py

@@ -36,7 +36,7 @@ def main(client: GoogleAdsClient, customer_id: str, campaign_id: str) -> None:
     parser.add_argument("-c", "--customer_id", required=True)
     parser.add_argument("-i", "--campaign_id", required=True)
     parser.add_argument(
-        "-v", "--api_version", type=str, default="v23", help="The Google Ads API version."
+        "-v", "--api_version", type=str, required=True, help="The Google Ads API version."
     )
     args = parser.parse_args()
     client = GoogleAdsClient.load_from_storage(version=args.api_version)