/// <summary>
/// Updates the status of a Merchant Center link request for a given resource name.
/// </summary>
/// <param name="customerId">The customer identifier.</param>
/// <param name="merchantCenterLinkService">The merchant center link service.</param>
/// <param name="merchantCenterLink">The merchant center link.</param>
/// <param name="status"></param>
private static void UpdateMerchantCenterLinkStatus(long customerId,
MerchantCenterLinkServiceClient merchantCenterLinkService,
MerchantCenterLink merchantCenterLink, MerchantCenterLinkStatus status)
{
// Enables the pending link.
MerchantCenterLink linkToUpdate = new MerchantCenterLink()
{
ResourceName = merchantCenterLink.ResourceName,
Status = status
};
// Creates an operation.
MerchantCenterLinkOperation operation = new MerchantCenterLinkOperation()
{
Update = linkToUpdate,
UpdateMask = FieldMasks.AllSetFieldsOf(linkToUpdate)
};
// Updates the link.
MutateMerchantCenterLinkResponse mutateResponse =
merchantCenterLinkService.MutateMerchantCenterLink(
customerId.ToString(), operation);
// Displays the result.
Console.WriteLine($"The status of Merchant Center Link with resource name " +
$"'{mutateResponse.Result.ResourceName}' to Google Ads account : " +
$"{customerId} was updated to {status}.");
}
/// <summary>Snippet for ListMerchantCenterLinks</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void ListMerchantCenterLinks()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
string customerId = "";
// Make the request
ListMerchantCenterLinksResponse response = merchantCenterLinkServiceClient.ListMerchantCenterLinks(customerId);
}
/// <summary>Snippet for GetMerchantCenterLink</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void GetMerchantCenterLink()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER_ID]/merchantCenterLinks/[MERCHANT_CENTER_ID]";
// Make the request
MerchantCenterLink response = merchantCenterLinkServiceClient.GetMerchantCenterLink(resourceName);
}
/// <summary>Snippet for GetMerchantCenterLink</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void GetMerchantCenterLinkResourceNames()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
MerchantCenterLinkName resourceName = MerchantCenterLinkName.FromCustomerMerchantCenter("[CUSTOMER_ID]", "[MERCHANT_CENTER_ID]");
// Make the request
MerchantCenterLink response = merchantCenterLinkServiceClient.GetMerchantCenterLink(resourceName);
}
/// <summary>Snippet for GetMerchantCenterLinkAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task GetMerchantCenterLinkAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER]/merchantCenterLinks/[MERCHANT_CENTER_LINK]";
// Make the request
MerchantCenterLink response = await merchantCenterLinkServiceClient.GetMerchantCenterLinkAsync(resourceName);
}
/// <summary>Snippet for MutateMerchantCenterLink</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void MutateMerchantCenterLink()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
string customerId = "";
MerchantCenterLinkOperation operation = new MerchantCenterLinkOperation();
// Make the request
MutateMerchantCenterLinkResponse response = merchantCenterLinkServiceClient.MutateMerchantCenterLink(customerId, operation);
}
/// <summary>Snippet for ListMerchantCenterLinksAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task ListMerchantCenterLinksAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
string customerId = "";
// Make the request
ListMerchantCenterLinksResponse response = await merchantCenterLinkServiceClient.ListMerchantCenterLinksAsync(customerId);
}
/// <summary>Snippet for GetMerchantCenterLinkAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task GetMerchantCenterLinkResourceNamesAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
MerchantCenterLinkName resourceName = MerchantCenterLinkName.FromCustomerMerchantCenterLink("[CUSTOMER]", "[MERCHANT_CENTER_LINK]");
// Make the request
MerchantCenterLink response = await merchantCenterLinkServiceClient.GetMerchantCenterLinkAsync(resourceName);
}
/// <summary>Snippet for ListMerchantCenterLinks</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void ListMerchantCenterLinksRequestObject()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
ListMerchantCenterLinksRequest request = new ListMerchantCenterLinksRequest {
CustomerId = "",
};
// Make the request
ListMerchantCenterLinksResponse response = merchantCenterLinkServiceClient.ListMerchantCenterLinks(request);
}
/// <summary>Snippet for MutateMerchantCenterLinkAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task MutateMerchantCenterLinkAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
string customerId = "";
MerchantCenterLinkOperation operation = new MerchantCenterLinkOperation();
// Make the request
MutateMerchantCenterLinkResponse response = await merchantCenterLinkServiceClient.MutateMerchantCenterLinkAsync(customerId, operation);
}
/// <summary>Snippet for GetMerchantCenterLink</summary>
public void GetMerchantCenterLinkResourceNames()
{
// Snippet: GetMerchantCenterLink(MerchantCenterLinkName, CallSettings)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
MerchantCenterLinkName resourceName = MerchantCenterLinkName.FromCustomerMerchantCenterLink("[CUSTOMER]", "[MERCHANT_CENTER_LINK]");
// Make the request
MerchantCenterLink response = merchantCenterLinkServiceClient.GetMerchantCenterLink(resourceName);
// End snippet
}
/// <summary>Snippet for GetMerchantCenterLink</summary>
public void GetMerchantCenterLink()
{
// Snippet: GetMerchantCenterLink(string, CallSettings)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER]/merchantCenterLinks/[MERCHANT_CENTER_LINK]";
// Make the request
MerchantCenterLink response = merchantCenterLinkServiceClient.GetMerchantCenterLink(resourceName);
// End snippet
}
/// <summary>Snippet for GetMerchantCenterLink</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void GetMerchantCenterLinkRequestObject()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
GetMerchantCenterLinkRequest request = new GetMerchantCenterLinkRequest
{
ResourceNameAsMerchantCenterLinkName = MerchantCenterLinkName.FromCustomerMerchantCenterLink("[CUSTOMER]", "[MERCHANT_CENTER_LINK]"),
};
// Make the request
MerchantCenterLink response = merchantCenterLinkServiceClient.GetMerchantCenterLink(request);
}
/// <summary>Snippet for ListMerchantCenterLinksAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task ListMerchantCenterLinksRequestObjectAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
ListMerchantCenterLinksRequest request = new ListMerchantCenterLinksRequest {
CustomerId = "",
};
// Make the request
ListMerchantCenterLinksResponse response = await merchantCenterLinkServiceClient.ListMerchantCenterLinksAsync(request);
}
/// <summary>Snippet for GetMerchantCenterLinkAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task GetMerchantCenterLinkRequestObjectAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
GetMerchantCenterLinkRequest request = new GetMerchantCenterLinkRequest
{
ResourceNameAsMerchantCenterLinkName = MerchantCenterLinkName.FromCustomerMerchantCenter("[CUSTOMER_ID]", "[MERCHANT_CENTER_ID]"),
};
// Make the request
MerchantCenterLink response = await merchantCenterLinkServiceClient.GetMerchantCenterLinkAsync(request);
}
/// <summary>Snippet for MutateMerchantCenterLink</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void MutateMerchantCenterLinkRequestObject()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
MutateMerchantCenterLinkRequest request = new MutateMerchantCenterLinkRequest
{
CustomerId = "",
Operation = new MerchantCenterLinkOperation(),
};
// Make the request
MutateMerchantCenterLinkResponse response = merchantCenterLinkServiceClient.MutateMerchantCenterLink(request);
}
/// <summary>Snippet for GetMerchantCenterLinkAsync</summary>
public async Task GetMerchantCenterLinkAsync()
{
// Snippet: GetMerchantCenterLinkAsync(string, CallSettings)
// Additional: GetMerchantCenterLinkAsync(string, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER_ID]/merchantCenterLinks/[MERCHANT_CENTER_ID]";
// Make the request
MerchantCenterLink response = await merchantCenterLinkServiceClient.GetMerchantCenterLinkAsync(resourceName);
// End snippet
}
/// <summary>Snippet for GetMerchantCenterLinkAsync</summary>
public async Task GetMerchantCenterLinkResourceNamesAsync()
{
// Snippet: GetMerchantCenterLinkAsync(MerchantCenterLinkName, CallSettings)
// Additional: GetMerchantCenterLinkAsync(MerchantCenterLinkName, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
MerchantCenterLinkName resourceName = MerchantCenterLinkName.FromCustomerMerchantCenter("[CUSTOMER_ID]", "[MERCHANT_CENTER_ID]");
// Make the request
MerchantCenterLink response = await merchantCenterLinkServiceClient.GetMerchantCenterLinkAsync(resourceName);
// End snippet
}
/// <summary>Snippet for MutateMerchantCenterLinkAsync</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public async Task MutateMerchantCenterLinkRequestObjectAsync()
{
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
MutateMerchantCenterLinkRequest request = new MutateMerchantCenterLinkRequest
{
CustomerId = "",
Operation = new MerchantCenterLinkOperation(),
};
// Make the request
MutateMerchantCenterLinkResponse response = await merchantCenterLinkServiceClient.MutateMerchantCenterLinkAsync(request);
}
/// <summary>Snippet for ListMerchantCenterLinksAsync</summary>
public async Task ListMerchantCenterLinksAsync()
{
// Snippet: ListMerchantCenterLinksAsync(string, CallSettings)
// Additional: ListMerchantCenterLinksAsync(string, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
string customerId = "";
// Make the request
ListMerchantCenterLinksResponse response = await merchantCenterLinkServiceClient.ListMerchantCenterLinksAsync(customerId);
// End snippet
}
/// <summary>Snippet for MutateMerchantCenterLinkAsync</summary>
public async Task MutateMerchantCenterLinkAsync()
{
// Snippet: MutateMerchantCenterLinkAsync(string, MerchantCenterLinkOperation, CallSettings)
// Additional: MutateMerchantCenterLinkAsync(string, MerchantCenterLinkOperation, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
string customerId = "";
MerchantCenterLinkOperation operation = new MerchantCenterLinkOperation();
// Make the request
MutateMerchantCenterLinkResponse response = await merchantCenterLinkServiceClient.MutateMerchantCenterLinkAsync(customerId, operation);
// End snippet
}
/// <summary>Snippet for MutateMerchantCenterLink</summary>
public void MutateMerchantCenterLinkRequestObject()
{
// Snippet: MutateMerchantCenterLink(MutateMerchantCenterLinkRequest, CallSettings)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = MerchantCenterLinkServiceClient.Create();
// Initialize request argument(s)
MutateMerchantCenterLinkRequest request = new MutateMerchantCenterLinkRequest
{
CustomerId = "",
Operation = new MerchantCenterLinkOperation(),
ValidateOnly = false,
};
// Make the request
MutateMerchantCenterLinkResponse response = merchantCenterLinkServiceClient.MutateMerchantCenterLink(request);
// End snippet
}
/// <summary>Snippet for ListMerchantCenterLinksAsync</summary>
public async Task ListMerchantCenterLinksRequestObjectAsync()
{
// Snippet: ListMerchantCenterLinksAsync(ListMerchantCenterLinksRequest, CallSettings)
// Additional: ListMerchantCenterLinksAsync(ListMerchantCenterLinksRequest, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
ListMerchantCenterLinksRequest request = new ListMerchantCenterLinksRequest {
CustomerId = "",
};
// Make the request
ListMerchantCenterLinksResponse response = await merchantCenterLinkServiceClient.ListMerchantCenterLinksAsync(request);
// End snippet
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="merchantCenterAccountId">The Merchant Center account ID for the account
/// requesting to link.</param>
public void Run(GoogleAdsClient client, long customerId, long merchantCenterAccountId)
{
// Get the MerchantCenterLinkService.
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient =
client.GetService(Services.V4.MerchantCenterLinkService);
try
{
// Rejects a pending link request or unlinks an enabled link for a Google Ads
// account with customerId from a Merchant Center account with
// merchantCenterAccountId.
ListMerchantCenterLinksResponse response =
merchantCenterLinkServiceClient.ListMerchantCenterLinks(customerId.ToString());
Console.WriteLine($"{response.MerchantCenterLinks.Count} Merchant Center link(s) " +
"found with the following details:");
foreach (MerchantCenterLink merchantCenterLink in response.MerchantCenterLinks)
{
Console.WriteLine($"Link '{merchantCenterLink.ResourceName}' has status " +
$"'{merchantCenterLink.Status}'.");
// Checks if there is a link for the Merchant Center account we are looking for.
if (merchantCenterAccountId == merchantCenterLink.Id.Value)
{
// If the Merchant Center link is pending, reject it by removing the link.
// If the Merchant Center link is enabled, unlink Merchant Center from
// Google Ads by removing the link.
// In both cases, the remove action is the same.
RemoveMerchantCenterLink(merchantCenterLinkServiceClient, customerId,
merchantCenterLink);
// There is only one MerchantCenterLink object for a given Google Ads
// account and Merchant Center account, so we can break early.
break;
}
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
/// <summary>Snippet for GetMerchantCenterLinkAsync</summary>
public async Task GetMerchantCenterLinkRequestObjectAsync()
{
// Snippet: GetMerchantCenterLinkAsync(GetMerchantCenterLinkRequest, CallSettings)
// Additional: GetMerchantCenterLinkAsync(GetMerchantCenterLinkRequest, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
GetMerchantCenterLinkRequest request = new GetMerchantCenterLinkRequest
{
ResourceNameAsMerchantCenterLinkName = MerchantCenterLinkName.FromCustomerMerchantCenterLink("[CUSTOMER]", "[MERCHANT_CENTER_LINK]"),
};
// Make the request
MerchantCenterLink response = await merchantCenterLinkServiceClient.GetMerchantCenterLinkAsync(request);
// End snippet
}
/// <summary>
/// Removes a Merchant Center link from a Google Ads client customer account.
/// </summary>
/// <param name="merchantCenterLinkServiceClient">The MerchantCenterLinkService
/// client.</param>
/// <param name="customerId">The client customer ID of the Google Ads account that has the
/// link request.</param>
/// <param name="merchantCenterLink">The MerchantCenterLink object to remove.</param>
private void RemoveMerchantCenterLink(
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient,
long customerId, MerchantCenterLink merchantCenterLink)
{
// Creates a single remove operation, specifying the Merchant Center link resource name.
MerchantCenterLinkOperation operation = new MerchantCenterLinkOperation
{
Remove = merchantCenterLink.ResourceName
};
// Sends the operation in a mutate request.
MutateMerchantCenterLinkResponse response =
merchantCenterLinkServiceClient.MutateMerchantCenterLink(
customerId.ToString(), operation);
Console.WriteLine("Removed Merchant Center Link with resource name: " +
$"{response.Result.ResourceName}");
}
/// <summary>Snippet for MutateMerchantCenterLinkAsync</summary>
public async Task MutateMerchantCenterLinkRequestObjectAsync()
{
// Snippet: MutateMerchantCenterLinkAsync(MutateMerchantCenterLinkRequest, CallSettings)
// Additional: MutateMerchantCenterLinkAsync(MutateMerchantCenterLinkRequest, CancellationToken)
// Create client
MerchantCenterLinkServiceClient merchantCenterLinkServiceClient = await MerchantCenterLinkServiceClient.CreateAsync();
// Initialize request argument(s)
MutateMerchantCenterLinkRequest request = new MutateMerchantCenterLinkRequest
{
CustomerId = "",
Operation = new MerchantCenterLinkOperation(),
};
// Make the request
MutateMerchantCenterLinkResponse response = await merchantCenterLinkServiceClient.MutateMerchantCenterLinkAsync(request);
// End snippet
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="merchantCenterAccountId">ID of the Merchant center whose link request is to be
/// approved</param>
public void Run(GoogleAdsClient client, long customerId, long merchantCenterAccountId)
{
// Get the MerchantCenterLink.
MerchantCenterLinkServiceClient merchantCenterLinkService = client.GetService(
Services.V6.MerchantCenterLinkService);
try
{
// Retrieve all the existing Merchant Center links.
// [START ApproveMerchantCenterLink]
ListMerchantCenterLinksResponse response =
merchantCenterLinkService.ListMerchantCenterLinks(customerId.ToString());
Console.WriteLine($"{response.MerchantCenterLinks.Count} Merchant Center link(s)" +
$" found with the following details:");
// [END ApproveMerchantCenterLink]
// Iterate the results, and filter for links with pending status.
foreach (MerchantCenterLink merchantCenterLink in response.MerchantCenterLinks)
{
// [START ApproveMerchantCenterLink_1]
Console.Write($"Link '{merchantCenterLink.ResourceName}' has status " +
$"'{merchantCenterLink.Status}'.");
// [END ApproveMerchantCenterLink_1]
// Checks if there is a link for the Merchant Center account we are looking
// for, then only approves the link if it is in a 'PENDING' state.
if (merchantCenterLink.Status == MerchantCenterLinkStatus.Pending &&
merchantCenterLink.Id == merchantCenterAccountId)
{
UpdateMerchantCenterLinkStatus(customerId, merchantCenterLinkService,
merchantCenterLink, MerchantCenterLinkStatus.Enabled);
}
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
