Changes for release v14.

Author: BenRKarl

ChangeLog

@@ -1,3 +1,19 @@
+* 21.2.0
+- Google Ads API v14 release.
+- Lower minimum version requirement for dependencies:
+  - google-api-core
+  - googleapis-common-protos
+  - proto-plus
+  - protobuf.
+- Update unit tests to run with lowest-supported Google-maintained dependencies.
+- Update upload_conversion_enhancement example with recommended placeholder names.
+- Update place_id field to place_ids in add_performance_max_for_travel_goals_campaign example.
+- Add add_things_to_do_ad example.
+- Remove examples:
+  - generate_forecast_metrics
+  - generate_historical_metrics
+  - get_campaign_criterion_bid_modifier_simulations
+
 * 21.1.0
 - Google Ads API v13_1 release.
 - Add Python versions 3.8, 3.9, and 3.10 to list of classifiers.

README.rst

@@ -35,6 +35,16 @@ configuration option that specifies which type of protobuf message to use. For
 information on why this flag is important and what the differences are between
 the two message types, see the `Protobuf Messages`_ guide.
 
+Minimum Dependency Versions
+---------------------------
+Version `21.2.0`_ of this library *lowered* the minimum version for some
+dependencies in order to improve compatibility with other applications and
+packages that rely on `protobuf`_ version 3.
+
+Note that using protobuf 3 will cause performance degredations in this library,
+so you may experience slower response times. For optimal performance we
+recommend using protobuf versions 4.21.5 or higher.
+
 Miscellaneous
 -------------
 
@@ -63,11 +73,7 @@ Authors
 .. _Andrew Burke: https://github.com/AndrewMBurke
 .. _Laura Chevalier: https://github.com/laurachevalier4
 .. _Bob Hancock: https://github.com/bobhancock
-.. _12.0.0: https://pypi.org/project/google-ads/12.0.0/
-.. _14.0.0: https://pypi.org/project/google-ads/14.0.0/
-.. _15.0.0: https://pypi.org/project/google-ads/15.0.0/
-.. _v9: https://developers.google.com/google-ads/api/reference/rpc/v9/overview
-.. _v10: https://developers.google.com/google-ads/api/reference/rpc/v10/overview
-.. _EOL: https://endoflife.date/python
-.. _Google Ads Developer Blog: https://ads-developers.googleblog.com/
+.. _14.0.0: https://pypi.org/project/google-ads/14.0.0/.. _15.0.0: https://pypi.org/project/google-ads/15.0.0/
+.. _21.2.0: https://pypi.org/project/google-ads/21.2.0/
 .. _Protobuf Messages: https://developers.google.com/google-ads/api/docs/client-libs/python/protobuf-messages
+.. _protobuf: https://pypi.org/project/protobuf/

examples/account_management/approve_merchant_center_link.py

@@ -125,7 +125,7 @@ def update_merchant_center_link_status(
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description=("Approves a Merchant Center link request.")

examples/account_management/create_customer.py

@@ -58,7 +58,7 @@ def main(client, manager_customer_id):
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description=("Creates a new client under the given manager.")

examples/account_management/get_account_hierarchy.py

@@ -179,7 +179,7 @@ def print_account_hierarchy(
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description="This example gets the account hierarchy of the specified "

examples/account_management/get_account_information.py

@@ -55,7 +55,7 @@ def main(client, customer_id):
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description=(

examples/account_management/get_change_details.py

@@ -186,7 +186,7 @@ def main(client, customer_id):
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description="This example gets specific details about the most recent "

examples/account_management/get_change_summary.py

@@ -85,7 +85,7 @@ def main(client, customer_id):
 if __name__ == "__main__":
     # GoogleAdsClient will read a google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description=(

examples/account_management/get_pending_invitations.py

@@ -65,7 +65,7 @@ def main(client, customer_id):
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description=("Retrieves pending invitations for a customer account.")

examples/account_management/invite_user_with_access_role.py

@@ -59,7 +59,7 @@ def main(client, customer_id, email_address, access_role):
 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="v13")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
 
     parser = argparse.ArgumentParser(
         description=(