Bid Manager API v1.1 has been sunset. Requests to a sunset version may return an error or incomplete data.

You must use Bid Manager API v2. See our migration guide for steps in migrating from v1.1 to v2.

Method: queries.reports.list

Lists reports associated with a query.

HTTP request

GET https://doubleclickbidmanager.googleapis.com/v2/queries/{queryId}/reports

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
queryId

string (int64 format)

Required. ID of the query with which the reports are associated.

Query parameters

Parameters
pageSize

integer

Maximum number of results per page. Must be between 1 and 100. Defaults to 100 if unspecified.
pageToken

string

A page token, received from a previous list call. Provide this to retrieve the subsequent page of reports.
orderBy

string

Name of a field used to order results. The default sorting order is ascending. To specify descending order for a field, append a " desc" suffix. For example "key.reportId desc".

Sorting is only supported for the following fields:

  • key.reportId

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "reports": [
    {
      object (Report)
    }
  ],
  "nextPageToken": string
}
Fields
reports[]

object (Report)

Retrieved reports.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page of reports. If this field is omitted, there are no subsequent pages.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.