Changes for release July 2022 Release. (#672)

googleads · Jul 22, 2022 · 5b7336b · 5b7336b
1 parent 9541a75
commit 5b7336b
Show file tree

Hide file tree

Showing 1,698 changed files with 589 additions and 232,530 deletions.
diff --git a/ChangeLog b/ChangeLog
@@ -1,3 1,10 @@
 * 18.0.0
 - Remove support for Google Ads API v9.
 - Added "pb" user agent key/value pair.
 - Change validate_text_ad example to use an RSA instead of ETA.
 - Rename get_artifact_metadata example to search_for_google_ads_fields.
 - Fix various issues in create_experiment example.
 
 * 17.0.0
 - Google Ads API v11_0 release.
 - Added example create_experiment.

diff --git a/examples/account_management/approve_merchant_center_link.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=("Approves a Merchant Center link request.")

diff --git a/examples/account_management/create_customer.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=("Creates a new client under the given manager.")

diff --git a/examples/account_management/get_account_hierarchy.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="This example gets the account hierarchy of the specified "

diff --git a/examples/account_management/get_account_information.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/account_management/get_change_details.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="This example gets specific details about the most recent "

diff --git a/examples/account_management/get_change_summary.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/account_management/get_pending_invitations.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=("Retrieves pending invitations for a customer account.")

diff --git a/examples/account_management/invite_user_with_access_role.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/account_management/link_manager_to_client.py b/examples/account_management/link_manager_to_client.py
@@ -112,7 112,7 @@ def main(client, customer_id, 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/account_management/list_accessible_customers.py b/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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  try:
  main(googleads_client)

diff --git a/examples/account_management/reject_merchant_center_link.py b/examples/account_management/reject_merchant_center_link.py
@@ -131,7 131,7 @@ def _remove_merchant_center_link(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/account_management/update_user_access.py b/examples/account_management/update_user_access.py
@@ -137,7 137,7 @@ def _modify_user_access(client, customer_id, user_id, 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="This code example updates the access role of a user, "

diff --git a/examples/advanced_operations/add_ad_customizer.py b/examples/advanced_operations/add_ad_customizer.py
@@ -401,7 401,7 @@ def _create_ads_with_customizations(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_ad_group_bid_modifier.py b/examples/advanced_operations/add_ad_group_bid_modifier.py
@@ -65,7 65,7 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_app_campaign.py b/examples/advanced_operations/add_app_campaign.py
@@ -297,7 297,7 @@ def _create_ad_text_asset(client, text):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_bidding_data_exclusion.py b/examples/advanced_operations/add_bidding_data_exclusion.py
@@ -80,7 80,7 @@ def main(client, customer_id, start_date_time, end_date_time):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds a data exclusion for conversions in Smart Bidding "

diff --git a/examples/advanced_operations/add_bidding_seasonality_adjustment.py b/examples/advanced_operations/add_bidding_seasonality_adjustment.py
@@ -94,7 94,7 @@ def main(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds a seasonality adjustment for conversions in Smart "

diff --git a/examples/advanced_operations/add_call_ad.py b/examples/advanced_operations/add_call_ad.py
@@ -101,7 101,7 @@ def main(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=("Adds a call extension to a specific account.")

diff --git a/examples/advanced_operations/add_display_upload_ad.py b/examples/advanced_operations/add_display_upload_ad.py
@@ -150,7 150,7 @@ def _create_display_upload_ad_group_ad(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds a display upload ad to a given ad group."

diff --git a/examples/advanced_operations/add_dynamic_page_feed.py b/examples/advanced_operations/add_dynamic_page_feed.py
@@ -365,7 365,7 @@ def _add_dsa_targeting(client, customer_id, ad_group_resource_name, label):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_dynamic_page_feed_asset.py b/examples/advanced_operations/add_dynamic_page_feed_asset.py
@@ -233,7 233,7 @@ def _add_dsa_target(client, dsa_page_url_label, customer_id, ad_group_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_dynamic_search_ads.py b/examples/advanced_operations/add_dynamic_search_ads.py
@@ -260,7 260,7 @@ def _add_webpage_criterion(client, customer_id, ad_group_resource_name):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_expanded_text_ad_with_upgraded_urls.py b/examples/advanced_operations/add_expanded_text_ad_with_upgraded_urls.py
@@ -92,7 92,7 @@ def main(client, customer_id, ad_group_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_local_campaign.py b/examples/advanced_operations/add_local_campaign.py
@@ -337,7 337,7 @@ def _create_youtube_video_asset(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds a Local Campaign to the given account."

diff --git a/examples/advanced_operations/add_performance_max_campaign.py b/examples/advanced_operations/add_performance_max_campaign.py
@@ -670,7 670,7 @@ def _create_asset_group_signal_operation(client, customer_id, audience_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=("Creates a Performance Max campaign.")

diff --git a/examples/advanced_operations/add_responsive_search_ad_with_ad_customizer.py b/examples/advanced_operations/add_responsive_search_ad_with_ad_customizer.py
@@ -212,7 212,7 @@ def _create_responsive_search_ad_with_customization(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/add_smart_campaign.py b/examples/advanced_operations/add_smart_campaign.py
@@ -786,7 786,7 @@ def _print_response_details(response):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(description=("Creates a Smart campaign."))
  # The following argument(s) should be provided to run the example.

diff --git a/examples/advanced_operations/add_smart_display_ad.py b/examples/advanced_operations/add_smart_display_ad.py
@@ -336,7 336,7 @@ def _handle_googleads_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/create_and_attach_shared_keyword_set.py b/examples/advanced_operations/create_and_attach_shared_keyword_set.py
@@ -111,7 111,7 @@ def _handle_googleads_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/find_and_remove_criteria_from_shared_set.py b/examples/advanced_operations/find_and_remove_criteria_from_shared_set.py
@@ -135,7 135,7 @@ def _handle_googleads_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/advanced_operations/get_ad_group_bid_modifiers.py b/examples/advanced_operations/get_ad_group_bid_modifiers.py
@@ -99,7 99,7 @@ def main(client, customer_id, page_size, ad_group_id=None):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="List ad group bid modifiers for specified customer."

diff --git a/examples/advanced_operations/use_cross_account_bidding_strategy.py b/examples/advanced_operations/use_cross_account_bidding_strategy.py
@@ -219,7 219,7 @@ def _attach_cross_account_bidding_strategy_to_campaign(
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(description=("Creates a Smart campaign."))
  # The following argument(s) should be provided to run the example.

diff --git a/examples/advanced_operations/use_portfolio_bidding_strategy.py b/examples/advanced_operations/use_portfolio_bidding_strategy.py
@@ -125,7 125,7 @@ def _handle_googleads_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds a campaign for specified customer."

diff --git a/examples/basic_operations/add_ad_groups.py b/examples/basic_operations/add_ad_groups.py
@@ -49,7 49,7 @@ def main(client, customer_id, campaign_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds an ad group for specified customer and campaign id."

diff --git a/examples/basic_operations/add_campaigns.py b/examples/basic_operations/add_campaigns.py
@@ -116,7 116,7 @@ def _handle_googleads_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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="Adds a campaign for specified customer."

diff --git a/examples/basic_operations/add_expanded_text_ads.py b/examples/basic_operations/add_expanded_text_ads.py
@@ -67,7 67,7 @@ def main(client, customer_id, ad_group_id, number_of_ads):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/basic_operations/add_keywords.py b/examples/basic_operations/add_keywords.py
@@ -64,7 64,7 @@ def main(client, customer_id, ad_group_id, keyword_text):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/basic_operations/add_responsive_search_ad.py b/examples/basic_operations/add_responsive_search_ad.py
@@ -89,7 89,7 @@ def _create_ad_text_asset(client, text, pinned_field=None):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description=(

diff --git a/examples/basic_operations/get_ad_groups.py b/examples/basic_operations/get_ad_groups.py
@@ -55,7 55,7 @@ def main(client, customer_id, page_size, campaign_id=None):
 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="v10")
  googleads_client = GoogleAdsClient.load_from_storage(version="v11")
 
  parser = argparse.ArgumentParser(
  description="List ad groups for specified customer."