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.
Formats in the Search Ads 360 Reporting API
The request format depends on the type of request you make.
Search
You can customize your search output by defining a search query
to suit your needs. The Search Ads 360 Query Language allows you to search all
resources for a list of entities that match a specific set of criteria. All
requests, regardless of the entity type, are made against the
SearchAds360Service. See Create search reports and
Search Ads 360 Query Language
to learn more.
The fields populated in the response depend on the service you use:
SearchAds360Service- The response includes one
SearchAds360Row object for each entity that
matches your search parameters. Each row contains one object, for example, a
campaign, and includes only the fields you request in your query.
- Specific services
- You can only request one entity at a time by resource name. The response
includes all fields for that entity.
In the new API, you must specify your Customer ID as a 10-digit number
(XXXXXXXXXX) without dashes.
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 2024-12-05 UTC.
[null,null,["Last updated 2024-12-05 UTC."],[[["Search Ads 360 API request formats vary depending on whether you're searching or requesting specific entities."],["Searches utilize the Search Ads 360 Query Language and the `SearchAds360Service` for customized results."],["Responses from `SearchAds360Service` include a `SearchAds360Row` for each matching entity, containing only the requested fields."],["Requests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes."]]],["Search requests utilize the Search Ads 360 Query Language against the `SearchAds360Service` to retrieve entities matching specific criteria. Responses from `SearchAds360Service` return `SearchAds360Row` objects, including only requested fields. Specific service requests retrieve one entity by resource name, returning all its fields. The Customer ID in the API must be a 10-digit number without dashes. The user can use the \"Create search reports\" or \"Search Ads 360 Query Language\" to learn more.\n"]]
