Method: sizes.list
Stay organized with collections
Save and categorize content based on your preferences.
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/v4/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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eRetrieves a list of globally unique sizes, which may include values not currently used by your account and might differ from those in the Trafficking UI.\u003c/p\u003e\n"],["\u003cp\u003eFilter the size list by IDs, height, width, or select only IAB standard sizes using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a collection of sizes with their respective properties, identified as a \u003ccode\u003edfareporting#sizesListResponse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/dfatrafficking\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: sizes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SizesListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves 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.\n\n### HTTP request\n\n`GET https://dfareporting.googleapis.com/dfareporting/v4/userprofiles/{profileId}/sizes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `profile``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` User profile ID associated with this request. |\n\n### Query parameters\n\n| Parameters ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------|\n| `ids[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Select only sizes with these IDs. |\n| `height` | `integer` Select only sizes with this height. |\n| `iab``Standard` | `boolean` Select only IAB standard sizes. |\n| `width` | `integer` Select only sizes with this width. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nSize sizes.list Response\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"sizes\": [ { object (/doubleclick-advertisers/rest/v4/sizes#Size) } ] } ``` |\n\n| Fields ||\n|-----------|-----------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#sizesListResponse\"` . |\n| `sizes[]` | `object (`[Size](/doubleclick-advertisers/rest/v4/sizes#Size)`)` Size collection. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/dfatrafficking`"]]