The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
List Accessible Customers
Stay organized with collections
Save and categorize content based on your preferences.
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()
Download list_accessible_customers.py
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);
}
}
}
Download ListAccessibleCustomers.java
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis page provides code samples in Python and Java that demonstrate how to list all accessible customers in Search Ads 360.\u003c/p\u003e\n"],["\u003cp\u003eThe code utilizes the Search Ads 360 API to retrieve and display a list of customer resource names that the authenticated user has access to.\u003c/p\u003e\n"],["\u003cp\u003eDownloadable links for both the Python and Java code examples are provided for easy implementation.\u003c/p\u003e\n"]]],["The Python and Java code samples demonstrate how to list all accessible customers using the Search Ads 360 API. They initialize a `SearchAds360Client`, then use `CustomerServiceClient` to send a request for a list of accessible customers. The response is processed to extract and print the total count and the resource names of each accessible customer. The Python script also includes error handling with a try-except block.\n"],null,["# List Accessible Customers\n\n### Python\n\n\n```python\n#!/usr/bin/env python\n# Copyright 2022 Google LLC\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# https://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\"\"\"Lists all accessible customers.\"\"\"\n\nimport traceback\nfrom util_searchads360 import SearchAds360Client\n\n\ndef main(client) -\u003e None:\n customer_service = client.get_customer_service()\n\n # Issues a list accessible customer request.\n accessible_customers = customer_service.list_accessible_customers()\n result_total = len(accessible_customers.resource_names)\n print(f\"Total results: {result_total}\")\n\n resource_names = accessible_customers.resource_names\n for resource_name in resource_names:\n print(f'Accessible customer resource name: \"{resource_name}\"')\n\n\nif __name__ == \"__main__\":\n # SearchAds360Client will read the search-ads-360.yaml configuration file in\n # the home directory if none is specified.\n search_ads_360_client = SearchAds360Client.load_from_file()\n\n try:\n main(search_ads_360_client)\n except Exception: # pylint: disable=broad-except\n traceback.print_exc()\n```\n\n\u003cbr /\u003e\n\n[Download list_accessible_customers.py](/static/search-ads/reporting/sample-code/list_accessible_customers.py)\n\n### Java\n\n\n```java\n// Copyright 2022 Google LLC\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// https://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\npackage sample;\n\nimport com.google.ads.searchads360.v0.lib.SearchAds360Client;\nimport com.google.ads.searchads360.v0.services.CustomerServiceClient;\nimport com.google.ads.searchads360.v0.services.ListAccessibleCustomersRequest;\nimport com.google.ads.searchads360.v0.services.ListAccessibleCustomersResponse;\n\n/** List all customers that can be accessed by the authenticated Google account. */\npublic class ListAccessibleCustomers {\n\n public static void main(String[] args) {\n try {\n // Creates a SearchAds360Client with local properties file\n final SearchAds360Client searchAds360Client =\n SearchAds360Client.newBuilder().fromPropertiesFile().build();\n // Creates the Customer Service Client.\n CustomerServiceClient client = searchAds360Client.createCustomerServiceClient();\n new ListAccessibleCustomers().runExample(client);\n } catch (Exception exception) {\n System.err.printf(\"Failed with exception: %s%n\", exception);\n exception.printStackTrace();\n System.exit(1);\n }\n }\n\n private void runExample(CustomerServiceClient customerServiceClient) {\n ListAccessibleCustomersResponse response =\n customerServiceClient.listAccessibleCustomers(\n ListAccessibleCustomersRequest.getDefaultInstance());\n\n System.out.printf(\"Total results: %d%n\", response.getResourceNamesCount());\n\n for (String customerResourceName : response.getResourceNamesList()) {\n System.out.printf(\"Customer resource name: %s%n\", customerResourceName);\n }\n }\n}\n```\n\n\u003cbr /\u003e\n\n[Download ListAccessibleCustomers.java](/static/search-ads/reporting/sample-code/ListAccessibleCustomers.java)"]]