Pour créer un compte, envoyez à l'API Google Ads un Customer prérempli. Contrairement à la création d'autres entités telles que des campagnes, cette opération s'effectue à l'aide d'une méthode CreateCustomerClient spéciale sur CustomerService plutôt qu'avec une méthode "mutate". Dans la méthode CreateCustomerClient, vous spécifiez le numéro client du compte administrateur qui gérera le nouveau client, et non le numéro client du client qui sera modifié comme d'habitude.
Voici le code illustrant la création d'un client:
Java
private void runExample(GoogleAdsClient googleAdsClient, Long managerId) {
// Formats the current date/time to use as a timestamp in the new customer description.
String dateTime = ZonedDateTime.now().format(DateTimeFormatter.RFC_1123_DATE_TIME);
// Initializes a Customer object to be created.
Customer customer =
Customer.newBuilder()
.setDescriptiveName("Account created with CustomerService on '" + dateTime + "'")
.setCurrencyCode("USD")
.setTimeZone("America/New_York")
// Optional: Sets additional attributes of the customer.
.setTrackingUrlTemplate("{lpurl}?device={device}")
.setFinalUrlSuffix("keyword={keyword}&matchtype={matchtype}&adgroupid={adgroupid}")
.build();
// Sends the request to create the customer.
try (CustomerServiceClient client =
googleAdsClient.getLatestVersion().createCustomerServiceClient()) {
CreateCustomerClientResponse response =
client.createCustomerClient(managerId.toString(), customer);
System.out.printf(
"Created a customer with resource name '%s' under the manager account with"
+ " customer ID '%d'.%n",
response.getResourceName(), managerId);
}
}
C#
public void Run(GoogleAdsClient client, long managerCustomerId)
{
// Get the CustomerService.
CustomerServiceClient customerService = client.GetService(Services.V16.CustomerService);
Customer customer = new Customer()
{
DescriptiveName = $"Account created with CustomerService on '{DateTime.Now}'",
// For a list of valid currency codes and time zones see this documentation:
// https://developers.google.com/google-ads/api/reference/data/codes-formats#codes_formats.
CurrencyCode = "USD",
TimeZone = "America/New_York",
// The below values are optional. For more information about URL
// options see: https://support.google.com/google-ads/answer/6305348.
TrackingUrlTemplate = "{lpurl}?device={device}",
FinalUrlSuffix = "keyword={keyword}&matchtype={matchtype}&adgroupid={adgroupid}"
};
try
{
// Create the account.
CreateCustomerClientResponse response = customerService.CreateCustomerClient(
managerCustomerId.ToString(), customer);
// Display the result.
Console.WriteLine($"Created a customer with resource name " +
$"'{response.ResourceName}' under the manager account with customer " +
$"ID '{managerCustomerId}'");
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
PHP
public static function runExample(GoogleAdsClient $googleAdsClient, int $managerCustomerId)
{
$customer = new Customer([
'descriptive_name' => 'Account created with CustomerService on ' . date('Ymd h:i:s'),
// For a list of valid currency codes and time zones see this documentation:
// https://developers.google.com/google-ads/api/reference/data/codes-formats.
'currency_code' => 'USD',
'time_zone' => 'America/New_York',
// The below values are optional. For more information about URL
// options see: https://support.google.com/google-ads/answer/6305348.
'tracking_url_template' => '{lpurl}?device={device}',
'final_url_suffix' => 'keyword={keyword}&matchtype={matchtype}&adgroupid={adgroupid}'
]);
// Issues a mutate request to create an account
$customerServiceClient = $googleAdsClient->getCustomerServiceClient();
$response = $customerServiceClient->createCustomerClient(
CreateCustomerClientRequest::build($managerCustomerId, $customer)
);
printf(
'Created a customer with resource name "%s" under the manager account with '
. 'customer ID %d.%s',
$response->getResourceName(),
$managerCustomerId,
PHP_EOL
);
}
Python
def main(client, manager_customer_id):
customer_service = client.get_service("CustomerService")
customer = client.get_type("Customer")
now = datetime.today().strftime("%Y%m%d %H:%M:%S")
customer.descriptive_name = f"Account created with CustomerService on {now}"
# For a list of valid currency codes and time zones see this documentation:
# https://developers.google.com/google-ads/api/reference/data/codes-formats
customer.currency_code = "USD"
customer.time_zone = "America/New_York"
# The below values are optional. For more information about URL
# options see: https://support.google.com/google-ads/answer/6305348
customer.tracking_url_template = "{lpurl}?device={device}"
customer.final_url_suffix = (
"keyword={keyword}&matchtype={matchtype}" "&adgroupid={adgroupid}"
)
response = customer_service.create_customer_client(
customer_id=manager_customer_id, customer_client=customer
)
print(
f'Customer created with resource name "{response.resource_name}" '
f'under manager account with ID "{manager_customer_id}".'
)
Ruby
def create_customer(manager_customer_id)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
customer = client.resource.customer do |c|
c.descriptive_name = "Account created with CustomerService on #{(Time.new.to_f * 1000).to_i}"
# For a list of valid currency codes and time zones, see this documentation:
# https://developers.google.com/google-ads/api/reference/data/codes-formats
c.currency_code = "USD"
c.time_zone = "America/New_York"
# The below values are optional. For more information about URL options, see:
# https://support.google.com/google-ads/answer/6305348
c.tracking_url_template = "{lpurl}?device={device}"
c.final_url_suffix = "keyword={keyword}&matchtype={matchtype}&adgroupid={adgroupid}"
end
response = client.service.customer.create_customer_client(
customer_id: manager_customer_id,
customer_client: customer
)
puts "Created a customer with resource name #{response.resource_name} under" +
" the manager account with customer ID #{manager_customer_id}."
end
Perl
sub create_customer {
my ($api_client, $manager_customer_id) = @_;
# Initialize a customer to be created.
my $customer = Google::Ads::GoogleAds::V16::Resources::Customer->new({
descriptiveName => "Account created with CustomerService on #" . uniqid(),
# For a list of valid currency codes and time zones, see this documentation:
# https://developers.google.com/google-ads/api/reference/data/codes-formats
currencyCode => "USD",
timeZone => "America/New_York",
# The below values are optional. For more information about URL options, see:
# https://support.google.com/google-ads/answer/6305348
trackingUrlTemplate => "{lpurl}?device={device}",
finalUrlSuffix =>
"keyword={keyword}&matchtype={matchtype}&adgroupid={adgroupid}"
});
# Create the customer client.
my $create_customer_client_response =
$api_client->CustomerService()->create_customer_client({
customerId => $manager_customer_id,
customerClient => $customer
});
printf
"Created a customer with resource name '%s' under the manager account " .
"with customer ID %d.\n", $create_customer_client_response->{resourceName},
$manager_customer_id;
return 1;
}