Changes for release v20_0. (#1008)

Author: BenRKarl

ChangeLog

@@ -1,3 +1,9 @@
+* 27.0.0
+- Google Ads API v20_0 release.
+- Remove Google Ads API v17.
+- Add example for generating audience insights.
+- Add example for creating demand gen campaign.
+
 * 26.1.0
 - Google Ads API v19_1 release.
 - Add two new examples for budget recommendations.

Dockerfile

@@ -22,7 +22,7 @@ RUN apt-get update -qy && \
         python3.10 \
         python3.11 \
         python3.12 && \
-    curl -fsSo /tmp/get-pip.py https://bootstrap.pypa.io/get-pip.py && \
+    curl -fsSo /tmp/get-pip.py https://bootstrap.pypa.io/pip/3.8/get-pip.py && \
     python3.8 /tmp/get-pip.py && \
     python3.8 -m pip install --no-cache-dir --upgrade pip && \
     python3.9 /tmp/get-pip.py && \
@@ -37,4 +37,4 @@ RUN apt-get update -qy && \
     python3 -m pip install --no-cache-dir "nox>=2020.12.31,<2022.6" && \
     rm -rf /var/cache/apt/lists
 
-WORKDIR "/google-ads-python"
+WORKDIR "/google-ads-python"

examples/account_management/create_customer.py

@@ -28,6 +28,7 @@
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 
+
 # [START create_customer]
 def main(client, manager_customer_id):
     customer_service = client.get_service("CustomerService")
@@ -73,7 +74,7 @@ def main(client, manager_customer_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.manager_customer_id)

examples/account_management/get_account_hierarchy.py

@@ -197,7 +197,7 @@ def print_account_hierarchy(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
     try:
         main(googleads_client, args.login_customer_id)
     except GoogleAdsException as ex:

examples/account_management/get_change_details.py

@@ -196,7 +196,7 @@ def main(client, customer_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
     try:
         main(googleads_client, args.customer_id)
     except GoogleAdsException as ex:

examples/account_management/get_change_summary.py

@@ -14,8 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""This example gets a list of which resources have been changed in an account.
-"""
+"""This example gets a list of which resources have been changed in an account."""
 
 
 import argparse
@@ -98,7 +97,7 @@ def main(client, customer_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id)

examples/account_management/invite_user_with_access_role.py

@@ -90,7 +90,7 @@ def main(client, customer_id, email_address, access_role):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/account_management/link_manager_to_client.py

@@ -131,7 +131,7 @@ def main(client, customer_id, manager_customer_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
     try:
         main(googleads_client, args.customer_id, args.manager_customer_id)
     except GoogleAdsException as ex:

examples/account_management/list_accessible_customers.py

@@ -44,7 +44,7 @@ def main(client):
 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="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client)

examples/account_management/update_user_access.py

@@ -167,7 +167,7 @@ def modify_user_access(client, customer_id, user_id, access_role):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
     try:
         main(
             googleads_client,

examples/account_management/verify_advertiser_identity.py

@@ -144,7 +144,7 @@ def start_identity_verification(client, customer_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id)

examples/advanced_operations/add_ad_customizer.py

@@ -287,7 +287,7 @@ def create_ad_with_customizations(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.ad_group_id)

examples/advanced_operations/add_ad_group_bid_modifier.py

@@ -92,7 +92,7 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_app_campaign.py

@@ -310,7 +310,7 @@ def create_ad_text_asset(client, text):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id)

examples/advanced_operations/add_bidding_data_exclusion.py

@@ -111,7 +111,7 @@ def main(client, customer_id, start_date_time, end_date_time):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_bidding_seasonality_adjustment.py

@@ -133,7 +133,7 @@ def 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="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_call_ad.py

@@ -146,7 +146,7 @@ def 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="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_display_upload_ad.py

@@ -170,7 +170,7 @@ def create_display_upload_ad_group_ad(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.ad_group_id)

examples/advanced_operations/add_dynamic_page_feed_asset.py

@@ -288,7 +288,7 @@ def add_dsa_target(client, customer_id, ad_group_id, dsa_page_url_label):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_dynamic_search_ads.py

@@ -275,7 +275,7 @@ def add_webpage_criterion(client, customer_id, ad_group_resource_name):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id)

examples/advanced_operations/add_performance_max_campaign.py

@@ -829,7 +829,7 @@ def create_asset_group_signal_operations(client, customer_id, audience_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_responsive_search_ad_full.py

@@ -588,7 +588,7 @@ def add_geo_targeting(client, customer_id, campaign_resource_name):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/add_smart_campaign.py

@@ -872,7 +872,7 @@ def print_response_details(response):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/create_and_attach_shared_keyword_set.py

@@ -130,6 +130,6 @@ def handle_googleads_exception(exception):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     main(googleads_client, args.customer_id, args.campaign_id)

examples/advanced_operations/find_and_remove_criteria_from_shared_set.py

@@ -149,6 +149,6 @@ def handle_googleads_exception(exception):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     main(googleads_client, args.customer_id, args.campaign_id)

examples/advanced_operations/get_ad_group_bid_modifiers.py

@@ -116,7 +116,7 @@ def main(client, customer_id, ad_group_id=None):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/use_cross_account_bidding_strategy.py

@@ -245,7 +245,7 @@ def attach_cross_account_bidding_strategy_to_campaign(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/advanced_operations/use_portfolio_bidding_strategy.py

@@ -138,6 +138,6 @@ def handle_googleads_exception(exception):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     main(googleads_client, args.customer_id)

examples/assets/add_call.py

@@ -161,7 +161,7 @@ def link_asset_to_account(client, customer_id, asset_resource_name):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(

examples/assets/add_hotel_callout.py

@@ -137,7 +137,7 @@ def link_asset_to_account(client, customer_id, resource_names):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.language_code)

examples/assets/add_lead_form_asset.py

@@ -195,7 +195,7 @@ def create_lead_form_campaign_asset(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.campaign_id)

examples/assets/add_prices.py

@@ -197,7 +197,7 @@ def add_asset_to_account(client, customer_id, price_asset_resource_name):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id)

examples/assets/add_sitelinks.py

@@ -155,7 +155,7 @@ def link_sitelinks_to_campaign(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.campaign_id)

examples/audience_insights/generate_audience_insights.py

@@ -44,22 +44,22 @@ def main(client, customer_id, custom_name):
         customer_id,
         location_id,
         user_interest_category,
-        custom_name
+        custom_name,
     )
     generate_suggested_targeting_insights(
         client,
         audience_insights_service,
         googleads_service,
         customer_id,
         location_id,
-        custom_name
+        custom_name,
     )
     list_audience_insights_attributes(
         client,
         audience_insights_service,
         customer_id,
         product_name,
-        custom_name
+        custom_name,
     )
 
 
@@ -71,7 +71,7 @@ def audience_composition_insights(
     customer_id,
     location_id,
     user_interest,
-    custom_name
+    custom_name,
 ):
     """Returns a collection of attributes represented in an audience of interest.
 
@@ -93,8 +93,8 @@ def audience_composition_insights(
 
     insights_info = client.get_type("InsightsAudienceAttributeGroup")
     attributes = client.get_type("AudienceInsightsAttribute")
-    attributes.user_interest.user_interest_category = googleads_service.user_interest_path(
-        customer_id, user_interest
+    attributes.user_interest.user_interest_category = (
+        googleads_service.user_interest_path(customer_id, user_interest)
     )
 
     insights_info.attributes.append(attributes)
@@ -126,7 +126,7 @@ def generate_suggested_targeting_insights(
     googleads_service,
     customer_id,
     location_id,
-    custom_name
+    custom_name,
 ):
     """Returns a collection of targeting insights (e.g.targetable audiences)
         that are relevant to the requested audience.
@@ -215,7 +215,7 @@ def list_audience_insights_attributes(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.custom_name)

examples/basic_operations/add_ad_groups.py

@@ -65,7 +65,7 @@ def main(client, customer_id, campaign_id):
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v19")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
 
     try:
         main(googleads_client, args.customer_id, args.campaign_id)