Method: sizes.list

  • This API retrieves a list of sizes, which can be filtered by various parameters.

  • The list of sizes may include values not currently in use by your account and may differ from the list seen in the Trafficking UI.

  • The HTTP request uses a GET method to the specified URL with a user profile ID as a path parameter.

  • Query parameters like ids, height, iabStandard, and width can be used to filter the results.

  • The response body contains a list of Size objects within a sizes array and requires the https://www.googleapis.com/auth/dfatrafficking OAuth scope for authorization.

Retrieves a list of sizes, possibly filtered. Retrieved sizes are globally unique and may include values not currently in use by your account. Due to this, the list of sizes returned by this method may differ from the list seen in the Trafficking UI.

HTTP request

GET https://dfareporting.googleapis.com/dfareporting/v5/userprofiles/{profileId}/sizes

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
profileId

string (int64 format)

User profile ID associated with this request.

Query parameters

Parameters
ids[]

string (int64 format)

Select only sizes with these IDs.
height

integer

Select only sizes with this height.
iabStandard

boolean

Select only IAB standard sizes.
width

integer

Select only sizes with this width.

Request body

The request body must be empty.

Response body

Size sizes.list Response

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

JSON representation 
{
  "kind": string,
  "sizes": [
    {
      object (Size)
    }
  ]
}
Fields
kind

string

Identifies what kind of resource this is. Value: the fixed string

"dfareporting#sizesListResponse"

.
sizes[]

object (Size)

Size collection.

Authorization scopes

Requires the following OAuth scope:

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