แสดงรายการบัญชีที่เข้าถึงได้

คุณสามารถแสดงรายชื่อลูกค้าที่คุณเข้าถึงได้ด้วย ListAccessibleCustomers ใน CustomerService อย่างไรก็ตาม มีความจำเป็น เพื่อทำความเข้าใจว่าลูกค้ารายใดแสดงผลในคำขอประเภทนี้

รายชื่อลูกค้าที่เข้าถึงได้เป็นหนึ่งในไม่กี่คำขอใน Google Ads API ที่ คุณไม่จำเป็นต้องระบุรหัสลูกค้าในคำขอ และจะไม่สนใจ login-customer-id ที่ระบุ

รายชื่อลูกค้าที่ได้จะอิงตามข้อมูลเข้าสู่ระบบ OAuth จะแสดงรายชื่อบัญชีทั้งหมดที่คุณสามารถดำเนินการได้ โดยตรง โดยใช้ข้อมูลเข้าสู่ระบบปัจจุบันของคุณ ซึ่งอาจไม่ได้รวม บัญชีทั้งหมดภายในลำดับชั้นบัญชี แต่จะรวมเฉพาะบัญชี ซึ่งมีการเพิ่มผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์แล้วพร้อมสิทธิ์ระดับผู้ดูแลระบบหรือสิทธิ์อื่นๆ ใน ของคุณได้

สมมติว่าคุณเป็นผู้ใช้ A ซึ่งเป็นผู้ดูแลระบบของ M1 และ C3 ใน 2 ลำดับชั้น ตามภาพด้านบน หากคุณเรียกใช้ 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);
    }
  }
}
ListAccessibleCustomers.java
      

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;
    }
}
ListAccessibleCustomers.cs
      

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);
    }
}
ListAccessibleCustomers.php
      

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}"')
list_accessible_customers.py
      

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
list_accessible_customers.rb
      

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;
}
list_accessible_customers.pl
      

แสดงรายการบัญชีที่ยกเลิก

Google Ads API ไม่ได้มีวิธีโดยตรงในการแสดงบัญชีที่ยกเลิกภายใต้ บัญชีดูแลจัดการ แต่คุณสามารถใช้วิธีแก้ไขปัญหาต่อไปนี้เพื่อเรียกข้อมูล รายการนี้

1. ดึงข้อมูลรายการลิงก์ ACTIVE โดยใช้แหล่งข้อมูล customer_client_link และสร้างรายชื่อลูกค้าโดยใช้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
   

2. เรียกข้อมูลรายชื่อ ENABLED บัญชีโดยใช้ทรัพยากร customer_client

   SELECT customer_client.id, customer_client.descriptive_name FROM customer_client
   

3. ความแตกต่างระหว่าง 2 รายการนี้จะแสดงรายการบัญชีที่ถูกยกเลิก