您可以使用 CustomerService
中的 ListAccessibleCustomers
方法列出您可以存取的客戶。然而,您必須瞭解這類要求會傳回哪些客戶。
「可存取商家資訊」的客戶是 Search Ads 360 Reporting API 中的少數要求之一,不需要在要求中指定客戶 ID (系統會忽略所有提供的 login-customer-id
)。
系統會根據您的 OAuth 憑證列出客戶清單。這項要求會傳回您能夠以目前的憑證「直接」採取行動的所有帳戶清單。這不一定包含帳戶階層中的所有帳戶,只會包含由已驗證使用者新增的帳戶,且具備該帳戶的管理員或其他權限。
假設您使用者 A
,同時是上圖中 M1
和 C3
的管理員。如要呼叫 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); } } }下載 ListAccessibleCustomers.java
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()下載 list_available_customers.py