Sdf: download

AI-generated Key Takeaways

The SDF Download service of the Bid Manager API is discontinued and users should transition to the DV360 API for similar functionality.
The DV360 API's SDF download requires authorization with the https://www.googleapis.com/auth/doubleclickbidmanager scope.
Users can retrieve entities like campaigns, insertion orders, line items, ad groups, ads, and inventory sources in SDF format using the new API.
The request body for the DV360 API allows for filtering downloaded entities by type and ID, and specifying the SDF version for the output.

Retrieves entities in SDF format. Try it now.

POST https://www.googleapis.com/doubleclickbidmanager/v1.1/sdf/download

This request requires authorization with the following scope:

Scope
`https://www.googleapis.com/auth/doubleclickbidmanager`

For more information, see the authentication and authorization page.

In the request body, supply data with the following structure:

{
  "fileTypes": [
    string
  ],
  "filterType": string,
  "filterIds": [
    long
  ],
  "version": string
}

Property name	Value	Description
`fileTypes[]`	`list`	File types that will be returned. If INVENTORY_SOURCE is requested, no other file types may be requested. Acceptable values are: "`AD`" "`AD_GROUP`" "`CAMPAIGN`" "`INSERTION_ORDER`" "`INVENTORY_SOURCE`" "`LINE_ITEM`"
`filterType`	`string`	Filter type used to filter entities to fetch. PARTNER_ID and INVENTORY_SOURCE_ID may only be used when downloading inventory sources. Acceptable values are: "`ADVERTISER_ID`" "`CAMPAIGN_ID`" "`INSERTION_ORDER_ID`" "`INVENTORY_SOURCE_ID`" "`LINE_ITEM_ID`" "`PARTNER_ID`"
`filterIds[]`	`list`	The IDs of the specified filter type. This is used to filter entities to fetch. At least one ID must be specified. Only one ID is allowed for the `ADVERTISER_ID` filter type. For `INSERTION_ORDER_ID` or `LINE_ITEM_ID` filter types all IDs must be from the same Advertiser.
`version`	`string`	SDF Version (column names, types, order) in which the entities will be returned. Default to `5.3`.

If successful, this method returns a response body with the following structure:

{
  "campaigns": string,
  "insertionOrders": string,
  "lineItems": string,
  "adGroups": string,
  "ads": string,
  "inventorySources": string
}

Property name	Value	Description
`insertionOrders`	`string`	Retrieved insertion orders in SDF format.
`lineItems`	`string`	Retrieved line items in SDF format.
`adGroups`	`string`	Retrieved ad groups in SDF format.
`ads`	`string`	Retrieved ads in SDF format.
`campaigns`	`string`	Retrieved campaigns in SDF format.
`inventorySources`	`string`

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.