アクセス可能な顧客を一覧表示するには、
ListAccessibleCustomers
メソッド（CustomerService 内）ただし、この種類のリクエストでどのお客様が返されるのかを理解する必要があります。
アクセス可能なユーザーを一覧表示することは、Google Ads API で
リクエストでお客様 ID を指定する必要はなく、何も指定しなくても
login-customer-id で提供される。
お客様のリストは OAuth 認証情報に基づいて作成されます。このリクエストは、現在の認証情報を提供すると直接に操作できるすべてのアカウントのリストを返します。これには、必ずしもアカウント階層内のすべてのアカウントが含まれるわけではなく、認証されたユーザーがアカウントの管理者などの権利で追加されたアカウントだけを含みます。
上の写真の 2 つの階層で M1 と C3 の管理者であるユーザー A ならば、たとえば次のような目的で Google Ads API を呼び出す場合、
GoogleAdsService、次にアクセスできます:
アカウント M1、C1、C2 の情報
および C3。ただし、CustomerService.ListAccessibleCustomers を呼び出すと M1 と C3 のみが返されます。これらのみがユーザー A に対して直接的なアクセス権が付与されるアカウントであることがその理由です。
以下は、CustomerService.ListAccessibleCustomers の使用を示すコード例です。
メソッド:
Java
private void runExample(GoogleAdsClient client) {
// Optional: Change credentials to use a different refresh token, to retrieve customers
// available for a specific user.
//
// UserCredentials credentials =
// UserCredentials.newBuilder()
// .setClientId("INSERT_OAUTH_CLIENT_ID")
// .setClientSecret("INSERT_OAUTH_CLIENT_SECRET")
// .setRefreshToken("INSERT_REFRESH_TOKEN")
// .build();
//
// client = client.toBuilder().setCredentials(credentials).build();
try (CustomerServiceClient customerService =
client.getLatestVersion().createCustomerServiceClient()) {
ListAccessibleCustomersResponse response =
customerService.listAccessibleCustomers(
ListAccessibleCustomersRequest.newBuilder().build());
System.out.printf("Total results: %d%n", response.getResourceNamesCount());
for (String customerResourceName : response.getResourceNamesList()) {
System.out.printf("Customer resource name: %s%n", customerResourceName);
}
}
}
C#
public void Run(GoogleAdsClient client)
{
// Get the CustomerService.
CustomerServiceClient customerService = client.GetService(Services.V17.CustomerService);
try
{
// Retrieve the list of customer resources.
string[] customerResourceNames = customerService.ListAccessibleCustomers();
// Display the result.
foreach (string customerResourceName in customerResourceNames)
{
Console.WriteLine(
$"Found customer with resource name = '{customerResourceName}'.");
}
}
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)
{
$customerServiceClient = $googleAdsClient->getCustomerServiceClient();
// Issues a request for listing all accessible customers.
$accessibleCustomers =
$customerServiceClient->listAccessibleCustomers(new ListAccessibleCustomersRequest());
print 'Total results: ' . count($accessibleCustomers->getResourceNames()) . PHP_EOL;
// Iterates over all accessible customers' resource names and prints them.
foreach ($accessibleCustomers->getResourceNames() as $resourceName) {
/** @var string $resourceName */
printf("Customer resource name: '%s'%s", $resourceName, PHP_EOL);
}
}
Python
def main(client):
customer_service = client.get_service("CustomerService")
accessible_customers = customer_service.list_accessible_customers()
result_total = len(accessible_customers.resource_names)
print(f"Total results: {result_total}")
resource_names = accessible_customers.resource_names
for resource_name in resource_names:
print(f'Customer resource name: "{resource_name}"')
Ruby
def list_accessible_customers()
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
accessible_customers = client.service.customer.list_accessible_customers().resource_names
accessible_customers.each do |resource_name|
puts "Customer resource name: #{resource_name}"
end
end
Perl
sub list_accessible_customers {
my ($api_client) = @_;
my $list_accessible_customers_response =
$api_client->CustomerService()->list_accessible_customers();
printf "Total results: %d.\n",
scalar @{$list_accessible_customers_response->{resourceNames}};
foreach
my $resource_name (@{$list_accessible_customers_response->{resourceNames}})
{
printf "Customer resource name: '%s'.\n", $resource_name;
}
return 1;
}
利用を停止したアカウントの一覧を取得する
Google Ads API では、キャンセル済みのアカウントを クライアント センター（MCC）アカウント。ただし、次の回避策を使用してデータを ご覧ください。
customer_client_linkリソースを使用してACTIVEリンクのリストを取得するcustomer_client_link.client_customerを使って顧客リストを作成する 表示されます。SELECT customer_client_link.client_customer, customer_client_link.status FROM customer_client_link WHERE customer_client_link.status = ACTIVEcustomer_clientリソースを使用して、ENABLEDアカウントのリストを取得します。SELECT customer_client.id, customer_client.descriptive_name FROM customer_client2 つのリストの違いから、利用を停止したアカウントのリストが表示されます。