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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-25 UTC."],[[["\u003cp\u003eThis code snippet demonstrates how to retrieve campaign data, including name, ID, and status, from a Search Ads 360 account using the Search Ads 360 API.\u003c/p\u003e\n"],["\u003cp\u003eThe provided examples showcase implementations in both Python and Java, allowing users to choose their preferred language.\u003c/p\u003e\n"],["\u003cp\u003eUsers need to provide their Search Ads 360 customer ID and optionally a login customer ID to execute the code.\u003c/p\u003e\n"],["\u003cp\u003eThe retrieved campaign data is printed to the console, displaying the campaign name, ID, and status for each campaign found.\u003c/p\u003e\n"]]],["The provided code examples demonstrate how to retrieve campaign data from Search Ads 360 using both Python and Java. They establish a connection to the Search Ads 360 service, define a query to select campaign name, ID, and status, and send a search request. The results are then iterated through, printing each campaign's name, ID, and status. Both examples use a client to connect to the service and use command line arguments to specify customer Ids.\n"],null,["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\"\"\"Retrieves campaigns for a customer using a pagination search request.\"\"\"\n\nimport argparse\nimport traceback\nfrom google.ads.searchads360.v0.services.types.search_ads360_service import SearchSearchAds360Request\nfrom util_searchads360 import SearchAds360Client\n\n_DEFAULT_PAGE_SIZE = 10000\n\n\ndef main(client, customer_id, page_size) -\u003e None:\n search_ads_360_service = client.get_service()\n\n query = \"\"\"\n SELECT\n campaign.name,\n campaign.id,\n campaign.status\n FROM campaign\"\"\"\n\n request = SearchSearchAds360Request()\n request.customer_id = customer_id\n request.query = query\n request.page_size = page_size\n\n # Issues a search request.\n results = search_ads_360_service.search(request=request)\n\n for row in results:\n campaign = row.campaign\n print(\n f'campaign \"{campaign.name}\" has id {campaign.id} and status {campaign.status.name}'\n )\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 parser = argparse.ArgumentParser(\n description=(\"Retrieves campaigns for a customer.\"))\n # Arguments to provide to run the example.\n parser.add_argument(\n \"-c\",\n \"--customer_id\",\n type=str,\n required=True,\n help=\"The Search Ads 360 customer ID (10 digits, no dashes).\",\n )\n\n parser.add_argument(\n \"-l\",\n \"--login_customer_id\",\n type=str,\n required=False,\n help=\"The Search Ads 360 login customer ID (10 digits, no dashes).\",\n )\n\n args = parser.parse_args()\n\n search_ads_360_client.set_ids(args.customer_id, args.login_customer_id)\n\n try:\n main(search_ads_360_client, args.customer_id, _DEFAULT_PAGE_SIZE)\n except Exception: # pylint: disable=broad-except\n traceback.print_exc()\n```\n\n\u003cbr /\u003e\n\n[Download get_campaigns.py](/static/search-ads/reporting/sample-code/get_campaigns.py)\n\nJava\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.beust.jcommander.Parameter;\nimport com.google.ads.searchads360.v0.lib.SearchAds360Client;\nimport com.google.ads.searchads360.v0.services.SearchAds360Row;\nimport com.google.ads.searchads360.v0.services.SearchAds360ServiceClient;\nimport com.google.ads.searchads360.v0.services.SearchAds360ServiceClient.SearchPagedResponse;\nimport com.google.ads.searchads360.v0.services.SearchSearchAds360Request;\n\n/** Get campaign details. */\npublic class GetCampaigns {\n private static final int PAGE_SIZE = 200;\n\n private static class GetCampaignsParams extends CodeSampleParams {\n\n @Parameter(names = \"--customerId\", required = true)\n private String customerId;\n\n @Parameter(names = \"--loginCustomerId\")\n private String loginCustomerId;\n }\n\n public static void main(String[] args) {\n GetCampaignsParams params = new GetCampaignsParams();\n if (!params.parseArguments(args)) {\n // Optional: You may pass the loginCustomerId on the command line or specify a loginCustomerId\n // here (10 digits, no dashes). If neither are set, customerId will be used as\n // loginCustomerId.\n // params.loginCustomerId = Long.parseLong(\"INSERT_LOGIN_CUSTOMER_ID_HERE\");\n }\n final String loginCustomerId = params.loginCustomerId;\n final String customerId = params.customerId;\n\n try {\n // Creates a SearchAds360Client with the specified loginCustomerId. If there's\n // no loginCustomerId, customerId will be used instead.\n final SearchAds360Client searchAds360Client =\n SearchAds360Client.newBuilder()\n .setLoginCustomerId(loginCustomerId == null ? customerId : loginCustomerId)\n .fromPropertiesFile()\n .build();\n // Creates the Search Ads 360 Service client.\n SearchAds360ServiceClient client = searchAds360Client.create();\n new GetCampaigns().runExample(client, customerId);\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(SearchAds360ServiceClient searchAds360ServiceClient, String customerId) {\n // Creates a query that retrieves all campaigns under the customerId.\n String query =\n \"\"\"\n SELECT campaign.name, campaign.id, campaign.status FROM campaign\n \"\"\";\n SearchSearchAds360Request request =\n SearchSearchAds360Request.newBuilder()\n .setCustomerId(customerId)\n .setQuery(query)\n .setPageSize(PAGE_SIZE)\n .build();\n\n // Issues a search request.\n final SearchPagedResponse searchPagedResponse = searchAds360ServiceClient.search(request);\n for (SearchAds360Row element : searchPagedResponse.iterateAll()) {\n System.out.printf(\n \"Campaign found with name '%s', ID %d, and status: %s.%n\",\n element.getCampaign().getName(),\n element.getCampaign().getId(),\n element.getCampaign().getStatus());\n }\n }\n}\n```\n\n\u003cbr /\u003e\n\n[Download GetCampaigns.java](/static/search-ads/reporting/sample-code/GetCampaigns.java)"]]