/// <summary>
/// Gets the customer user access given an email address.
/// </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="emailAddress">Email address of the user whose access role should be
/// retrieved.</param>
/// <returns>The user ID if a customer is found, or null if no matching customers were
/// found.</returns>
private long?GetUserAccess(GoogleAdsClient client, long customerId, string emailAddress)
{
// Get the GoogleAdsService.
GoogleAdsServiceClient googleAdsService = client.GetService(
Services.V6.GoogleAdsService);
// Create the search query. Use the LIKE query for filtering to ignore the text case
// for email address when searching for a match.
string searchQuery = "Select customer_user_access.user_id, " +
"customer_user_access.email_address, customer_user_access.access_role," +
"customer_user_access.access_creation_date_time from customer_user_access " +
$"where customer_user_access.email_address LIKE '{emailAddress}'";
// Retrieves the user accesses.
PagedEnumerable <SearchGoogleAdsResponse, GoogleAdsRow> searchPagedResponse =
googleAdsService.Search(customerId.ToString(), searchQuery);
GoogleAdsRow result = searchPagedResponse.FirstOrDefault();
// Displays the results.
if (result != null)
{
CustomerUserAccess access = result.CustomerUserAccess;
Console.WriteLine("Customer user access with User ID = {0}, Email Address = " +
"{1}, Access Role = {2} and Creation Time = {3} was found in " +
"Customer ID: {4}.", access.UserId, access.EmailAddress, access.AccessRole,
access.AccessCreationDateTime, customerId);
return(access.UserId);
}
else
{
Console.WriteLine("No customer user access with requested email was found.");
return(null);
}
}
/// <summary>
/// Modifies the user access role to a specified value.
/// </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="userId">ID of the user whose access role is modified.</param>
/// <param name="accessRole">The updated access role.</param>
private void ModifyUserAccess(GoogleAdsClient client, long customerId, long userId,
AccessRole accessRole)
{
// Get the CustomerUserAccessService.
CustomerUserAccessServiceClient userAccessService = client.GetService(
Services.V6.CustomerUserAccessService);
// Creates the modified user access.
CustomerUserAccess userAccess = new CustomerUserAccess()
{
ResourceName = ResourceNames.CustomerUserAccess(customerId, userId),
AccessRole = accessRole
};
// Creates the operation.
CustomerUserAccessOperation operation = new CustomerUserAccessOperation()
{
Update = userAccess,
UpdateMask = FieldMasks.AllSetFieldsOf(userAccess)
};
// Updates the user access.
MutateCustomerUserAccessResponse response =
userAccessService.MutateCustomerUserAccess(
customerId.ToString(), operation);
// Displays the result.
Console.WriteLine($"Successfully modified customer user access with " +
$"resource name '{response.Result.ResourceName}'.");
}
/// <summary>Snippet for GetCustomerUserAccess</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void GetCustomerUserAccessResourceNames()
{
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = CustomerUserAccessServiceClient.Create();
// Initialize request argument(s)
CustomerUserAccessName resourceName = CustomerUserAccessName.FromCustomerUser("[CUSTOMER_ID]", "[USER_ID]");
// Make the request
CustomerUserAccess response = customerUserAccessServiceClient.GetCustomerUserAccess(resourceName);
}
/// <summary>Snippet for GetCustomerUserAccess</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void GetCustomerUserAccess()
{
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = CustomerUserAccessServiceClient.Create();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER_ID]/customerUserAccesses/[USER_ID]";
// Make the request
CustomerUserAccess response = customerUserAccessServiceClient.GetCustomerUserAccess(resourceName);
}
/// <summary>Snippet for GetCustomerUserAccessAsync</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 GetCustomerUserAccessResourceNamesAsync()
{
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = await CustomerUserAccessServiceClient.CreateAsync();
// Initialize request argument(s)
CustomerUserAccessName resourceName = CustomerUserAccessName.FromCustomerUser("[CUSTOMER_ID]", "[USER_ID]");
// Make the request
CustomerUserAccess response = await customerUserAccessServiceClient.GetCustomerUserAccessAsync(resourceName);
}
/// <summary>Snippet for GetCustomerUserAccessAsync</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 GetCustomerUserAccessAsync()
{
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = await CustomerUserAccessServiceClient.CreateAsync();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER_ID]/customerUserAccesses/[USER_ID]";
// Make the request
CustomerUserAccess response = await customerUserAccessServiceClient.GetCustomerUserAccessAsync(resourceName);
}
/// <summary>Snippet for GetCustomerUserAccessAsync</summary>
public async Task GetCustomerUserAccessAsync()
{
// Snippet: GetCustomerUserAccessAsync(string, CallSettings)
// Additional: GetCustomerUserAccessAsync(string, CancellationToken)
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = await CustomerUserAccessServiceClient.CreateAsync();
// Initialize request argument(s)
string resourceName = "customers/[CUSTOMER_ID]/customerUserAccesses/[USER_ID]";
// Make the request
CustomerUserAccess response = await customerUserAccessServiceClient.GetCustomerUserAccessAsync(resourceName);
// End snippet
}
/// <summary>Snippet for GetCustomerUserAccess</summary>
public void GetCustomerUserAccessRequestObject()
{
// Snippet: GetCustomerUserAccess(GetCustomerUserAccessRequest, CallSettings)
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = CustomerUserAccessServiceClient.Create();
// Initialize request argument(s)
GetCustomerUserAccessRequest request = new GetCustomerUserAccessRequest
{
ResourceNameAsCustomerUserAccessName = CustomerUserAccessName.FromCustomerUser("[CUSTOMER_ID]", "[USER_ID]"),
};
// Make the request
CustomerUserAccess response = customerUserAccessServiceClient.GetCustomerUserAccess(request);
// End snippet
}
/// <summary>Snippet for GetCustomerUserAccessAsync</summary>
public async Task GetCustomerUserAccessResourceNamesAsync()
{
// Snippet: GetCustomerUserAccessAsync(CustomerUserAccessName, CallSettings)
// Additional: GetCustomerUserAccessAsync(CustomerUserAccessName, CancellationToken)
// Create client
CustomerUserAccessServiceClient customerUserAccessServiceClient = await CustomerUserAccessServiceClient.CreateAsync();
// Initialize request argument(s)
CustomerUserAccessName resourceName = CustomerUserAccessName.FromCustomerUser("[CUSTOMER_ID]", "[USER_ID]");
// Make the request
CustomerUserAccess response = await customerUserAccessServiceClient.GetCustomerUserAccessAsync(resourceName);
// End snippet
}
