Reports: list

Requires authorization

Retrieves a list of reports.

Request

HTTP request

GET https://www.googleapis.com/dfareporting/v2.8/userprofiles/profileId/reports

Parameters

Parameter name Value Description
Path parameters
profileId long The DFA user profile ID.
Optional query parameters
maxResults integer Maximum number of results to return. Acceptable values are 0 to 10, inclusive. (Default: 10)
pageToken string The value of the nextToken from the previous result page.
scope string The scope that defines which results are returned.

Acceptable values are:
  • "ALL": All reports in account.
  • "MINE": My reports. (default)
sortField string The field by which to sort the list.

Acceptable values are:
  • "ID": Sort by report ID.
  • "LAST_MODIFIED_TIME": Sort by 'lastModifiedTime' field. (default)
  • "NAME": Sort by name of reports.
sortOrder string Order of sorted results.

Acceptable values are:
  • "ASCENDING": Ascending order.
  • "DESCENDING": Descending order. (default)

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

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

Request body

Do not supply a request body with this method.

Response

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

{
  "kind": "dfareporting#reportList",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    reports Resource
  ]
}
Property name Value Description Notes
kind string The kind of list this is, in this case dfareporting#reportList.
etag etag The eTag of this response for caching purposes.
nextPageToken string Continuation token used to page through reports. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.
items[] list The reports returned in this response.

Send feedback about...

DoubleClick Campaign Manager
DoubleClick Campaign Manager