Changes for release 10.2.0. (#328)

googleads · Nov 12, 2021 · b1c7566 · b1c7566
1 parent ef3abd7
commit b1c7566
Show file tree

Hide file tree

Showing 4,477 changed files with 1,350,412 additions and 511,527 deletions.
diff --git a/ChangeLog b/ChangeLog
@@ -1,3 +1,23 @@
+10.2.0
+======
+- Added support for v9 of the Google Ads API.
+- Migrated some code examples to use Assets.
+ - Updated Extensions\AddHotelCallout.cs
+ - Updated Extensions\AddPrices.cs
+ - Updated Extensions\AddSitelinks.cs
+ - Added Extensions\AddSitelinksUsingAssets.cs
+ - Deleted Extensions\AddSitelinksUsingFeeds.cs
+- Fix https://github.com/googleads/google-ads-dotnet/issues/320. Use channel settings instead of environment variable to set proxy.
+- Updated AdvancedOperations/AddSmartCampaign.cs to use GetKeywordThemeSuggestions.
+- Separated the Summary and Detailed Log String Creation. Fix was contributed by Kevin
+(https://github.com/aukevin)
+- Added tests for async MediaUtilities. Fix was contributed by Jarrod Mosen
+(https://github.com/wub)
+- Regenerated all stubs to work with the latest code generator.
+- Added support for warnings. Updated Remarketing\UploadStoreSalesTransactions.cs example.
+- Upgraded all dependencies where possible.
+
+
 10.1.0
 ======
 

diff --git a/examples/AccountManagement/ApproveMerchantCenterLink.cs b/examples/AccountManagement/ApproveMerchantCenterLink.cs
@@ -15,14 +15,14 @@
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
 using Google.Ads.GoogleAds.Util;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
-using static Google.Ads.GoogleAds.V8.Enums.MerchantCenterLinkStatusEnum.Types;
+using static Google.Ads.GoogleAds.V9.Enums.MerchantCenterLinkStatusEnum.Types;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example demonstrates how to approve a Merchant Center link request.
@@ -109,7 +109,7 @@ public void Run(GoogleAdsClient client, long customerId, long merchantCenterAcco
  {
  // Get the MerchantCenterLink.
  MerchantCenterLinkServiceClient merchantCenterLinkService = client.GetService(
- Services.V8.MerchantCenterLinkService);
+ Services.V9.MerchantCenterLinkService);
 
  try
  {

diff --git a/examples/AccountManagement/CreateCustomer.cs b/examples/AccountManagement/CreateCustomer.cs
@@ -14,13 +14,13 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example illustrates how to create a new customer under a given manager account.
@@ -87,7 +87,7 @@ public static void Main(string[] args)
  public void Run(GoogleAdsClient client, long managerCustomerId)
  {
  // Get the CustomerService.
- CustomerServiceClient customerService = client.GetService(Services.V8.CustomerService);
+ CustomerServiceClient customerService = client.GetService(Services.V9.CustomerService);
 
  Customer customer = new Customer()
  {

diff --git a/examples/AccountManagement/GetAccountHierarchy.cs b/examples/AccountManagement/GetAccountHierarchy.cs
@@ -14,13 +14,13 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using Google.Api.Gax;
 using System;
 using System.Collections.Generic;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This example gets the account hierarchy of the specified manager account. If you don't
@@ -114,10 +114,10 @@ public void Run(GoogleAdsClient googleAdsClient, long? managerCustomerId = null,
  }
 
  GoogleAdsServiceClient googleAdsServiceClient =
- googleAdsClient.GetService(Services.V8.GoogleAdsService);
+ googleAdsClient.GetService(Services.V9.GoogleAdsService);
 
  CustomerServiceClient customerServiceClient =
- googleAdsClient.GetService(Services.V8.CustomerService);
+ googleAdsClient.GetService(Services.V9.CustomerService);
 
  // List of Customer IDs to handle.
  List<long> seedCustomerIds = new List<long>();

diff --git a/examples/AccountManagement/GetAccountInformation.cs b/examples/AccountManagement/GetAccountInformation.cs
@@ -14,13 +14,13 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example lists basic information about an advertising account, like the name,
@@ -82,7 +82,7 @@ public static void Main(string[] args)
  public void Run(GoogleAdsClient client, long customerId)
  {
  // Get the CustomerService.
- CustomerServiceClient customerService = client.GetService(Services.V8.CustomerService);
+ CustomerServiceClient customerService = client.GetService(Services.V9.CustomerService);
 
  try
  {

diff --git a/examples/AccountManagement/GetChangeDetails.cs b/examples/AccountManagement/GetChangeDetails.cs
@@ -15,17 +15,17 @@
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
 using Google.Ads.GoogleAds.Util;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using Google.Protobuf;
 using System;
 using System.Collections.Generic;
-using static Google.Ads.GoogleAds.V8.Enums.ChangeEventResourceTypeEnum.Types;
-using static Google.Ads.GoogleAds.V8.Enums.ResourceChangeOperationEnum.Types;
-using static Google.Ads.GoogleAds.V8.Resources.ChangeEvent.Types;
+using static Google.Ads.GoogleAds.V9.Enums.ChangeEventResourceTypeEnum.Types;
+using static Google.Ads.GoogleAds.V9.Enums.ResourceChangeOperationEnum.Types;
+using static Google.Ads.GoogleAds.V9.Resources.ChangeEvent.Types;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example gets the changes in an account during the last 25 days.
@@ -87,7 +87,7 @@ public void Run(GoogleAdsClient client, long customerId)
  {
  // Get the GoogleAdsService.
  GoogleAdsServiceClient googleAdsService = client.GetService(
- Services.V8.GoogleAdsService);
+ Services.V9.GoogleAdsService);
 
  // Construct a query to find details for recent changes in your account.
  // The LIMIT clause is required for the change_event resource.

diff --git a/examples/AccountManagement/GetChangeSummary.cs b/examples/AccountManagement/GetChangeSummary.cs
@@ -14,14 +14,14 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Services;
 using Google.Api.Gax;
 using System;
 using System.Collections.Generic;
-using static Google.Ads.GoogleAds.V8.Enums.ChangeStatusResourceTypeEnum.Types;
+using static Google.Ads.GoogleAds.V9.Enums.ChangeStatusResourceTypeEnum.Types;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example gets a list of which resources have been changed in your account
@@ -89,7 +89,7 @@ public void Run(GoogleAdsClient client, long customerId)
  {
  // Get the GoogleAdsService.
  GoogleAdsServiceClient googleAdsService = client.GetService(
- Services.V8.GoogleAdsService);
+ Services.V9.GoogleAdsService);
 
  string searchQuery = @"
  SELECT

diff --git a/examples/AccountManagement/GetPendingInvitations.cs b/examples/AccountManagement/GetPendingInvitations.cs
@@ -14,12 +14,12 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example retrieves pending invitations for a customer account. To create a pending
@@ -82,7 +82,7 @@ public void Run(GoogleAdsClient client, long customerId)
  {
  // Get the AdGroupService.
  GoogleAdsServiceClient googleAdsService = client.GetService(
- Services.V8.GoogleAdsService);
+ Services.V9.GoogleAdsService);
 
  // [START get_pending_invitations]
  // Create the search query.

diff --git a/examples/AccountManagement/InviteUserWithAccessRole.cs b/examples/AccountManagement/InviteUserWithAccessRole.cs
@@ -14,14 +14,14 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
-using static Google.Ads.GoogleAds.V8.Enums.AccessRoleEnum.Types;
+using static Google.Ads.GoogleAds.V9.Enums.AccessRoleEnum.Types;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example sends an invitation email to a user to manage a customer
@@ -114,7 +114,7 @@ public void Run(GoogleAdsClient client, long customerId, string emailAddress,
  {
  // Get the CustomerUserAccessInvitationService.
  CustomerUserAccessInvitationServiceClient service = client.GetService(
- Services.V8.CustomerUserAccessInvitationService);
+ Services.V9.CustomerUserAccessInvitationService);
 
  // [START invite_user_with_access_role]
  MutateCustomerUserAccessInvitationRequest invitationRequest =

diff --git a/examples/AccountManagement/LinkManagerToClient.cs b/examples/AccountManagement/LinkManagerToClient.cs
@@ -15,15 +15,15 @@
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
 using Google.Ads.GoogleAds.Util;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using static Google.Ads.GoogleAds.V8.Enums.ManagerLinkStatusEnum.Types;
+using static Google.Ads.GoogleAds.V9.Enums.ManagerLinkStatusEnum.Types;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example demonstrates how to link an existing Google Ads manager customer
@@ -138,7 +138,7 @@ private string CreateInvitation(GoogleAdsClient client, long managerCustomerId,
  {
  // Get the CustomerClientLinkService.
  CustomerClientLinkServiceClient customerClientLinkService =
- client.GetService(Services.V8.CustomerClientLinkService);
+ client.GetService(Services.V9.CustomerClientLinkService);
 
  // Create a client with the manager customer ID as login customer ID.
  client.Config.LoginCustomerId = managerCustomerId.ToString();
@@ -189,7 +189,7 @@ private string GetManagerLinkResourceName(GoogleAdsClient client, long managerCu
  {
  // Get the GoogleAdsService.
  GoogleAdsServiceClient googleAdsService =
- client.GetService(Services.V8.GoogleAdsService);
+ client.GetService(Services.V9.GoogleAdsService);
 
  // Create a client with the manager customer ID as login customer ID.
  client.Config.LoginCustomerId = managerCustomerId.ToString();
@@ -225,7 +225,7 @@ private void AcceptInvitation(GoogleAdsClient client, long clientCustomerId,
  {
  // Get the CustomerManagerLinkService.
  CustomerManagerLinkServiceClient customerManagerLinkService =
- client.GetService(Services.V8.CustomerManagerLinkService);
+ client.GetService(Services.V9.CustomerManagerLinkService);
 
  // Create a client with the manager customer ID as login customer ID.
  client.Config.LoginCustomerId = clientCustomerId.ToString();

diff --git a/examples/AccountManagement/ListAccessibleCustomers.cs b/examples/AccountManagement/ListAccessibleCustomers.cs
@@ -14,12 +14,12 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example lists the resource names for the customers that the authenticating user
@@ -78,7 +78,7 @@ public static void Main(string[] args)
  public void Run(GoogleAdsClient client)
  {
  // Get the CustomerService.
- CustomerServiceClient customerService = client.GetService(Services.V8.CustomerService);
+ CustomerServiceClient customerService = client.GetService(Services.V9.CustomerService);
 
  try
  {

diff --git a/examples/AccountManagement/RejectMerchantCenterLink.cs b/examples/AccountManagement/RejectMerchantCenterLink.cs
@@ -14,13 +14,13 @@
 
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using System;
 using System.Collections.Generic;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example demonstrates how to reject a Merchant Center link request.
@@ -105,7 +105,7 @@ public void Run(GoogleAdsClient client, long customerId, long merchantCenterAcco
  {
  // Get the MerchantCenterLinkService.
  MerchantCenterLinkServiceClient merchantCenterLinkServiceClient =
- client.GetService(Services.V8.MerchantCenterLinkService);
+ client.GetService(Services.V9.MerchantCenterLinkService);
 
  try
  {

diff --git a/examples/AccountManagement/UpdateUserAccess.cs b/examples/AccountManagement/UpdateUserAccess.cs
@@ -15,16 +15,16 @@
 using CommandLine;
 using Google.Ads.GoogleAds.Lib;
 using Google.Ads.GoogleAds.Util;
-using Google.Ads.GoogleAds.V8.Errors;
-using Google.Ads.GoogleAds.V8.Resources;
-using Google.Ads.GoogleAds.V8.Services;
+using Google.Ads.GoogleAds.V9.Errors;
+using Google.Ads.GoogleAds.V9.Resources;
+using Google.Ads.GoogleAds.V9.Services;
 using Google.Api.Gax;
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using static Google.Ads.GoogleAds.V8.Enums.AccessRoleEnum.Types;
+using static Google.Ads.GoogleAds.V9.Enums.AccessRoleEnum.Types;
 
-namespace Google.Ads.GoogleAds.Examples.V8
+namespace Google.Ads.GoogleAds.Examples.V9
 {
  /// <summary>
  /// This code example updates the access role of a user, given the email address.
@@ -152,7 +152,7 @@ public void Run(GoogleAdsClient client, long customerId, string emailAddress,
  {
  // Get the GoogleAdsService.
  GoogleAdsServiceClient googleAdsService = client.GetService(
- Services.V8.GoogleAdsService);
+ Services.V9.GoogleAdsService);
 
  // Create the search query. Use the LIKE query for filtering to ignore the text case
  // for email address when searching for a match.
@@ -196,7 +196,7 @@ private void ModifyUserAccess(GoogleAdsClient client, long customerId, long user
  {
  // Get the CustomerUserAccessService.
  CustomerUserAccessServiceClient userAccessService = client.GetService(
- Services.V8.CustomerUserAccessService);
+ Services.V9.CustomerUserAccessService);
 
  // Creates the modified user access.
  CustomerUserAccess userAccess = new CustomerUserAccess()