Agencies and Brands API
Agencies and brands API is an externally available HTTP API for ad agencies and brands to programmatically manage their deals and spending with Google Ad…
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
Agencies and brands API is an externally available HTTP API for ad agencies and brands to programmatically manage their deals and spending with Google Ad Manager publishers.
Endpoints 7
agencies.reports
- GETLists `Report` objects.
/v1/:parent/reports?filter=string&orderBy=string&pageSize=0&pageToken=string&skip=0Lists Report objects. - POSTCreates a `Report` object.
/v1/:parent/reportsCreates a Report object. - DELETEDeletes a `Report` object.
/v1/:nameDeletes a Report object. - PATCHUpdates a `Report` object.
/v1/:name?updateMask=stringUpdates a Report object. - POSTInitiates the execution of an existing report asynchronously
/v1/:name:runInitiates the execution of an existing report asynchronously. Users can get the report by polling this operation using OperationsService.GetOperation. Poll…
agencies.reports.operations
- GETGets the latest state of a long-running operation
/v1/:nameGets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
agencies.reports.results
- GETReturns the result rows from a completed report
/v1/:name:fetchRows?pageSize=0&pageToken=stringReturns the result rows from a completed report. The caller must have previously called RunReport and waited for that operation to complete. The rows will be…
API details
- Base URL
https://agenciesandbrands.googleapis.com- Authentication
- OAuth 2.0 (authorization code flow) with 1 scope
An API key in the key query parameter - Operations
- 7 operations on 4 pathsGET 3POST 2PATCH 1DELETE 1
- Main resources
- agencies.reports 5agencies.reports.operations 1agencies.reports.results 1
- Response formats
application/json- Description format
- Google API Discovery, API version
v1 - Links
- Documentation · OpenAPI document
- Listed from
- Google API Discovery document (googleapis/discovery-artifact-manager) (Apache-2.0)
How to test the Agencies and Brands 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 Agencies and Brands 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 “Lists `Report` objects.” (GET /v1/:parent/reports?filter=string&orderBy=string&pageSize=0&pageToken=string&skip=0), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Agencies and Brands API?
Agencies and brands API is an externally available HTTP API for ad agencies and brands to programmatically manage their deals and spending with Google Ad… It is listed under Developer tools and has 7 endpoints.
Who publishes the Agencies and Brands 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 Agencies and Brands API?
Requests go to https://agenciesandbrands.googleapis.com. Endpoint paths are added to this base URL.
How do I authenticate with the Agencies and Brands 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 Agencies and Brands API have?
7 operations on 4 paths (3 GET, 2 POST, 1 PATCH, 1 DELETE). The largest groups are agencies.reports, agencies.reports.operations, agencies.reports.results.
Is forking the Agencies and Brands API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.