Google Ads API là một công cụ mạnh mẽ giúp bạn quản lý và truy cập thông tin tài khoản một cách dễ dàng. Với API này, bạn có thể liệt kê các tài khoản mà bạn có quyền truy cập thông qua phương thức CustomerService.ListAccessibleCustomers. Đây là một trong số ít các phương thức cho phép bạn lấy danh sách khách hàng mà không cần cung cấp ID khách hàng trong yêu cầu. Bài viết này sẽ hướng dẫn chi tiết cách liệt kê tài khoản có thể truy cập và giải pháp để truy xuất danh sách tài khoản đã bị hủy.
Bạn có thể sử dụng phương thức ListAccessibleCustomers trong CustomerService để liệt kê các tài khoản mà bạn có quyền truy cập trong Google Ads. Tuy nhiên, cần lưu ý rằng kết quả trả về chỉ bao gồm những khách hàng mà bạn có quyền truy cập trực tiếp.
ListAccessibleCustomers là một trong số ít các yêu cầu của API Google Ads không yêu cầu bạn cung cấp customer_id trong yêu cầu và cũng bỏ qua giá trị login-customer-id nếu được cung cấp. Danh sách khách hàng thu được sẽ dựa trên thông tin đăng nhập OAuth của bạn. Phương thức này sẽ trả về tất cả các tài khoản mà bạn có quyền quản lý trực tiếp dựa trên quyền được gán cho tài khoản hiện tại, không nhất thiết bao gồm toàn bộ hệ thống tài khoản phân cấp mà bạn có thể liên quan.
Ví dụ: nếu bạn là người dùng A, quản trị viên của tài khoản M1 và C3 trong hệ thống phân cấp, khi thực hiện lệnh gọi API Google Ads như GoogleAdsService, bạn sẽ có quyền truy cập vào các tài khoản M1, C1, C2 và C3. Tuy nhiên, khi sử dụng CustomerService.ListAccessibleCustomers, chỉ các tài khoản M1 và C3 sẽ được liệt kê vì chúng là các tài khoản mà bạn có quyền truy cập trực tiếp.
Dưới đây là ví dụ về cách sử dụng phương thức CustomerService.ListAccessibleCustomers trong Google Ads API:
private void runExample(GoogleAdsClient client) {
// Tùy chọn: Thay đổi thông tin xác thực để sử dụng mã làm mới (refresh token) khác,
// nhằm truy xuất các khách hàng có sẵn cho một người dùng cụ thể.
//
// 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();client.getLatestVersion().createCustomerServiceClient()) {
ListAccessibleCustomersResponse response =
customerService.listAccessibleCustomers(
ListAccessibleCustomersRequest.newBuilder().build());
System.out.printf(“Tên tài nguyên khách hàng: %s%n”, customerResourceName);
}
}
}
Liệt kê tài khoản đã bị huỷ
Hiện tại, API Google Ads không cung cấp phương pháp trực tiếp để liệt kê các tài khoản đã bị huỷ trong tài khoản người quản lý. Tuy nhiên, bạn có thể sử dụng phương pháp sau để truy xuất danh sách này:
- Truy xuất danh sách các đường liên kết
ACTIVEbằng tài nguyêncustomer_client_linkvà tạo danh sách khách hàng từ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 - Truy xuất danh sách các tài khoản
ENABLEDbằng tài nguyêncustomer_client:
SELECT customer_client.id, customer_client.descriptive_name
FROM customer_client - Sự khác biệt giữa hai danh sách trên sẽ cung cấp cho bạn danh sách các tài khoản đã bị huỷ.
Việc sử dụng Google Ads API để quản lý và liệt kê các tài khoản giúp bạn tối ưu hóa quá trình quản lý hệ thống phân cấp tài khoản một cách dễ dàng và hiệu quả. Bằng cách tận dụng phương thức CustomerService.ListAccessibleCustomers, bạn có thể nhanh chóng truy xuất danh sách các tài khoản mà mình có quyền truy cập. Đồng thời, việc áp dụng các truy vấn nâng cao cũng giúp bạn quản lý và phát hiện các tài khoản đã bị hủy một cách hiệu quả. Điều này không chỉ giúp tối ưu quản trị mà còn tăng tính linh hoạt khi làm việc với các tài khoản Google Ads.
