您可以使用
ListAccessibleCustomers
方法CustomerService
。
不过,有必要了解一下此类请求会返回哪些客户。
列出可访问的客户是 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); } } }
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()