คุณสามารถแสดงรายชื่อลูกค้าที่คุณเข้าถึงได้ด้วย
ListAccessibleCustomers
ใน CustomerService
อย่างไรก็ตาม มีความจำเป็น
เพื่อทำความเข้าใจว่าลูกค้ารายใดแสดงผลในคำขอประเภทนี้
ข้อมูลลูกค้าที่เข้าถึงได้เป็นหนึ่งในคำขอไม่กี่รายการใน Search Ads 360 Reporting API
ที่คุณไม่จำเป็นต้องระบุรหัสลูกค้าในคำขอ
และจะไม่สนใจ
login-customer-id
รายชื่อลูกค้าที่ได้จะอิงตามข้อมูลเข้าสู่ระบบ OAuth จะแสดงรายชื่อบัญชีทั้งหมดที่คุณสามารถดำเนินการได้ โดยตรง โดยใช้ข้อมูลเข้าสู่ระบบปัจจุบันของคุณ ซึ่งไม่ได้รวมบัญชีทั้งหมดภายในบัญชีนี้ ลำดับชั้น แต่จะรวมเฉพาะบัญชี ที่มีการเพิ่มผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์แล้วพร้อมสิทธิ์ระดับผู้ดูแลระบบหรือสิทธิ์อื่นๆ ในบัญชี
สมมติว่าคุณเป็นผู้ใช้ A
ซึ่งเป็นผู้ดูแลระบบของ M1
และ C3
ในทั้ง 2 อย่าง
ลำดับชั้น
ตามภาพด้านบน หากคุณเรียกใช้ Search Ads 360 Reporting API เช่น
SearchAds360Service
คุณเข้าถึงข้อมูลสำหรับบัญชี M1
, C1
, C2
และ C3
อย่างไรก็ตาม ขอให้
CustomerService.ListAccessibleCustomers
จะ
แสดงผลเฉพาะ M1
และ C3
เนื่องจากเป็นบัญชีเดียวที่ผู้ใช้ A
มี
การเข้าถึงโดยตรง
ต่อไปนี้เป็นโค้ดตัวอย่างที่แสดงการใช้งาน
CustomerService.ListAccessibleCustomers
วิธีการ:
Java
// Copyright 2022 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package sample; import com.google.ads.searchads360.v0.lib.SearchAds360Client; import com.google.ads.searchads360.v0.services.CustomerServiceClient; import com.google.ads.searchads360.v0.services.ListAccessibleCustomersRequest; import com.google.ads.searchads360.v0.services.ListAccessibleCustomersResponse; /** List all customers that can be accessed by the authenticated Google account. */ public class ListAccessibleCustomers { public static void main(String[] args) { try { // Creates a SearchAds360Client with local properties file final SearchAds360Client searchAds360Client = SearchAds360Client.newBuilder().fromPropertiesFile().build(); // Creates the Customer Service Client. CustomerServiceClient client = searchAds360Client.createCustomerServiceClient(); new ListAccessibleCustomers().runExample(client); } catch (Exception exception) { System.err.printf("Failed with exception: %s%n", exception); exception.printStackTrace(); System.exit(1); } } private void runExample(CustomerServiceClient customerServiceClient) { ListAccessibleCustomersResponse response = customerServiceClient.listAccessibleCustomers( ListAccessibleCustomersRequest.getDefaultInstance()); System.out.printf("Total results: %d%n", response.getResourceNamesCount()); for (String customerResourceName : response.getResourceNamesList()) { System.out.printf("Customer resource name: %s%n", customerResourceName); } } }
Python
#!/usr/bin/env python # Copyright 2022 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # https://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """Lists all accessible customers.""" import traceback from util_searchads360 import SearchAds360Client def main(client) -> None: customer_service = client.get_customer_service() # Issues a list accessible customer request. 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'Accessible customer resource name: "{resource_name}"') if __name__ == "__main__": # SearchAds360Client will read the search-ads-360.yaml configuration file in # the home directory if none is specified. search_ads_360_client = SearchAds360Client.load_from_file() try: main(search_ads_360_client) except Exception: # pylint: disable=broad-except traceback.print_exc()