CustomerService
의 ListAccessibleCustomers
메서드를 사용하여 액세스 가능한 고객을 나열할 수 있습니다. 하지만 이러한 유형의 요청으로 반환되는 고객을 파악해야 합니다.
액세스 가능한 고객을 나열하는 것은 Google Ads API에서 요청에 고객 ID를 지정하지 않아도 되는 몇 가지 요청 중 하나이며, 제공된 login-customer-id
는 모두 무시됩니다.
이렇게 하면 OAuth 사용자 인증 정보를 기반으로 하는 고객 목록이 표시됩니다. 요청은 현재 사용자 인증 정보를 바탕으로 직접 조치를 취할 수 있는 모든 계정의 목록을 반환합니다. 여기에는 계정 계층 구조 내의 모든 계정이 반드시 포함되는 것은 아닙니다. 대신 인증된 사용자가 계정의 관리자 또는 다른 권한으로 추가된 계정만 포함됩니다.
위 그림에 나온 두 계층 구조에서 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; } }
2,399필리핀
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}"')
루비
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에서는 관리자 계정에 해지된 계정을 나열할 수 있는 직접적인 방법을 제공하지 않습니다. 그러나 다음 해결 방법을 사용하여 이 목록을 가져올 수 있습니다.
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 = ACTIVE
customer_client
리소스를 사용하여ENABLED
계정 목록을 가져옵니다.SELECT customer_client.id, customer_client.descriptive_name FROM customer_client
두 목록의 차이를 통해 해지된 계정 목록을 확인할 수 있습니다.