Search Ads 360 API
The Search Ads 360 API allows developers to automate uploading conversions and downloading reports from Search Ads 360.
E-commerce#openapi#analytics#media
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Search Ads 360 API allows developers to automate uploading conversions and downloading reports from Search Ads 360.
Endpoints 11
conversion
- GETRetrieves a list of conversions from a DoubleClick Search engine account.
/doubleclicksearch/v2/agency/:agencyId/advertiser/:advertiserId/engine/:engineAccountId/conversion?adGroupId=string&adId=string&campaignId=string&criterionId=string&customerId=string&endDate=0&rowCount=0&startDate=0&startRow=0Retrieves a list of conversions from a DoubleClick Search engine account. - GETRetrieves a list of conversions from a DoubleClick Search engine account.
/doubleclicksearch/v2/customer/:customerId/conversion?adGroupId=string&adId=string&advertiserId=string&agencyId=string&campaignId=string&criterionId=string&endDate=0&engineAccountId=string&rowCount=0&startDate=0&startRow=0Retrieves a list of conversions from a DoubleClick Search engine account. - PUTUpdates a batch of conversions in DoubleClick Search.
/doubleclicksearch/v2/conversionUpdates a batch of conversions in DoubleClick Search. - POSTInserts a batch of new conversions into DoubleClick Search.
/doubleclicksearch/v2/conversionInserts a batch of new conversions into DoubleClick Search. - POSTUpdates the availabilities of a batch of floodlight activities in DoubleClick Search.
/doubleclicksearch/v2/conversion/updateAvailabilityUpdates the availabilities of a batch of floodlight activities in DoubleClick Search.
reports
- POSTGenerates and returns a report immediately.
/doubleclicksearch/v2/reports/generateGenerates and returns a report immediately. - GETPolls for the status of a report request.
/doubleclicksearch/v2/reports/:reportIdPolls for the status of a report request. - GETDownloads a report file encoded in UTF-8.
/doubleclicksearch/v2/reports/:reportId/files/:reportFragmentDownloads a report file encoded in UTF-8. - GETDownloads a csv file(encoded in UTF-8) that contains ID mappings between legacy SA360 and new SA360
/doubleclicksearch/v2/agency/:agencyId/advertiser/:advertiserId/idmappingDownloads a csv file(encoded in UTF-8) that contains ID mappings between legacy SA360 and new SA360. The file includes all children entities of the given… - POSTInserts a report request into the reporting system.
/doubleclicksearch/v2/reportsInserts a report request into the reporting system.
savedColumns
- GETRetrieve the list of saved columns for a specified advertiser.
/doubleclicksearch/v2/agency/:agencyId/advertiser/:advertiserId/savedcolumnsRetrieve the list of saved columns for a specified advertiser.
API details
- Base URL
https://doubleclicksearch.googleapis.com- Authentication
- OAuth 2.0 (authorization code flow) with 1 scope
An API key in the key query parameter - Operations
- 11 operations on 10 pathsGET 6POST 4PUT 1
- Main resources
- conversion 5reports 5savedColumns 1
- Response formats
application/json- Description format
- Google API Discovery, API version
v2 - Links
- Documentation · OpenAPI document
- Listed from
- Google API Discovery document (googleapis/discovery-artifact-manager) (Apache-2.0)
How to test the Search Ads 360 API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Search Ads 360 API collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 1 scope. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Retrieves a list of conversions from a DoubleClick Search engine account.” (GET /doubleclicksearch/v2/agency/:agencyId/advertiser/:advertiserId/engine/:engineAccountId/conversion?adGroupId=string&adId=string&campaignId=string&criterionId=string&customerId=string&endDate=0&rowCount=0&startDate=0&startRow=0), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Search Ads 360 API?
The Search Ads 360 API allows developers to automate uploading conversions and downloading reports from Search Ads 360. It is listed under E-commerce and has 11 endpoints.
Who publishes the Search Ads 360 API?
It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Search Ads 360 API?
Requests go to https://doubleclicksearch.googleapis.com. Endpoint paths are added to this base URL.
How do I authenticate with the Search Ads 360 API?
It accepts 2 methods: OAuth 2.0 (authorization code flow) with 1 scope; an API key in the key query parameter.
How many endpoints does the Search Ads 360 API have?
11 operations on 10 paths (6 GET, 4 POST, 1 PUT). The largest groups are conversion, reports, savedColumns.
Is forking the Search Ads 360 API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.