Lineitems: downloadlineitems

  • The Line Items Settings service within the Bid Manager API is discontinued and users should transition to the DV360 API.

  • This documentation details the process for retrieving line items in CSV format using the downloadlineitems method, excluding YouTube & partners line items.

  • The request requires authorization with the https://www.googleapis.com/auth/doubleclickbidmanager scope.

  • Users can specify filters based on advertiser ID, insertion order ID, or line item ID to refine the data retrieved.

Retrieves line items in CSV format. YouTube & partners line items are not supported. Try it now.

Request

HTTP request

POST https://www.googleapis.com/doubleclickbidmanager/v1.1/lineitems/downloadlineitems

Authorization

This request requires authorization with the following scope:

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

For more information, see the authentication and authorization page.

Request body

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

{
  "filterType": string,
  "filterIds": [
    long
  ],
  "format": string,
  "fileSpec": string
}
Property name Value Description Notes
filterType string Filter type used to filter line items to fetch.

Acceptable values are:
  • "ADVERTISER_ID"
  • "INSERTION_ORDER_ID"
  • "LINE_ITEM_ID"
filterIds[] list IDs of the specified filter type used to filter line items to fetch. If omitted, all the line items will be returned.
format string Format in which the line items will be returned. Default to CSV.

Acceptable values are:
  • "CSV"
fileSpec string File specification (column names, types, order) in which the line items will be returned. Default to EWF.

Acceptable values are:
  • "EWF"

Response

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

{
  "lineItems": string
}
Property name Value Description Notes
lineItems string Retrieved line items in CSV format. For more information about file formats, see Entity Write File Format.

Try it!

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