Google

Curation Partners API

Curation partners API is an externally available HTTP API for curators to programmatically manage their data segments and curated packages used by ad agencies.

Developer tools#openapi

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

Curation partners API is an externally available HTTP API for curators to programmatically manage their data segments and curated packages used by ad agencies.

Endpoints 15

curators.dataSegments

  • POSTActivates a data segment./v1/:name:activateActivates a data segment.
  • POSTDeactivates a data segment./v1/:name:deactivateDeactivates a data segment.
  • GETList the data segments owned by a curator./v1/:parent/dataSegments?pageSize=0&pageToken=stringList the data segments owned by a curator.
  • POSTCreates a data segment owned by the listed curator/v1/:parent/dataSegmentsCreates a data segment owned by the listed curator. The data segment will be created in the ACTIVE state, meaning it will be immediately available for buyers…

curators.curatedPackages

  • GETLists curated packages owned by the specified curator./v1/:parent/curatedPackages?filter=string&pageSize=0&pageToken=stringLists curated packages owned by the specified curator.
  • POSTCreates a new curated package./v1/:parent/curatedPackagesCreates a new curated package.

curators.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.

curators.reports

  • DELETEDeletes a `Report` object./v1/:nameDeletes a Report object.
  • PATCHUpdates a `Report` object./v1/:name?updateMask=stringUpdates a Report object.
  • 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.
  • 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…

curators.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…

mediaPlanners

  • GETLists all media planner accounts that the caller has access to/v1/mediaPlanners?filter=string&pageSize=0&pageToken=stringLists all media planner accounts that the caller has access to. For curators, this will return all media planners that have accepted curator terms. For other…
  • GETSearches for media planner accounts matching the given DSP seat ID./v1/mediaPlanners:search?dspSeatId=string&pageSize=0&pageToken=stringSearches for media planner accounts matching the given DSP seat ID.

API details

Base URL
https://curationpartners.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 1 scope
An API key in the key query parameter
Operations
15 operations on 10 pathsGET 7POST 6PATCH 1DELETE 1
Main resources
curators.reports 5curators.dataSegments 4curators.curatedPackages 2mediaPlanners 2curators.reports.operations 1curators.reports.results 1
Response formats
application/json
Description format
Google API Discovery, API version v1

How to test the Curation Partners API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Curation Partners API collection, without the publisher's secrets.
  3. 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.
  4. Send a requestPick an endpoint, for example “Activates a data segment.” (POST /v1/:name:activate), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Curation Partners API?

Curation partners API is an externally available HTTP API for curators to programmatically manage their data segments and curated packages used by ad agencies. It is listed under Developer tools and has 15 endpoints.

Who publishes the Curation Partners 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 Curation Partners API?

Requests go to https://curationpartners.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Curation Partners 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 Curation Partners API have?

15 operations on 10 paths (7 GET, 6 POST, 1 PATCH, 1 DELETE). The largest groups are curators.reports, curators.dataSegments, curators.curatedPackages, mediaPlanners.

Is forking the Curation Partners API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.