A partire dall'8 settembre 2025, ogni nuovo elemento pubblicitario dovrà dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Consulta la nostra pagina dei ritiri per ulteriori dettagli su come aggiornare l'integrazione per effettuare questa dichiarazione.
Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 200. Se non specificato, verrà usato il valore predefinito 100.
pageToken
string
Un token che identifica una pagina di risultati che il server deve restituire. In genere, si tratta del valore di nextPageToken restituito dalla chiamata precedente al metodo partners.list. Se non specificato, verrà restituita la prima pagina di risultati.
orderBy
string
Campo in base al quale ordinare l'elenco. I valori accettati sono:
displayName
L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente di un campo, il suffisso "desc" al nome del campo. Ad esempio, displayName desc.
filter
string
Consente di filtrare in base ai campi del partner.
Sintassi supportata:
Le espressioni di filtro sono costituite da una o più restrizioni.
Le restrizioni possono essere combinate dagli operatori logici AND o OR. Una sequenza di limitazioni utilizza implicitamente AND.
Una limitazione ha il formato {field} {operator} {value}.
Tutti i campi devono utilizzare l'operatore EQUALS (=).
Campi supportati:
entityStatus
Esempi:
Tutti i partner attivi: entityStatus="ENTITY_STATUS_ACTIVE"
La lunghezza di questo campo non deve essere superiore a 500 caratteri.
Un token per recuperare la pagina successiva di risultati. Passa questo valore nel campo pageToken nella chiamata successiva al metodo partners.list per recuperare la pagina dei risultati successiva.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v1 is sunset and this document outlines the details for listing partners accessible to the current user.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epartners.list\u003c/code\u003e method allows you to retrieve a list of partners, filter and sort them based on specified criteria, and control pagination.\u003c/p\u003e\n"],["\u003cp\u003eIt requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of partners and a token for retrieving subsequent pages of results if available.\u003c/p\u003e\n"]]],["This document details the `partners.list` method for accessing Display & Video 360 partners. The HTTP `GET` request is made to `https://displayvideo.googleapis.com/v1/partners`. Key actions include using query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` to refine the partner list. The request body is empty. The response, formatted in JSON, includes a list of accessible partners and a `nextPageToken` for paginated results. Authorization requires the `https://www.googleapis.com/auth/display-video` scope.\n"],null,["# Method: partners.list\n\n| Display \\& Video 360 API v1 has been sunset.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPartnersResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists partners that are accessible to the current user.\n\nThe order is defined by the [orderBy](/display-video/api/reference/rest/v1/partners/list#body.QUERY_PARAMETERS.order_by) parameter.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v1/partners`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. If unspecified will default to `100`. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v1/partners/list#body.ListPartnersResponse.FIELDS.next_page_token) returned from the previous call to `partners.list` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `displayName` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. For example, `displayName desc`. |\n| `filter` | `string` Allows filtering by partner fields. Supported syntax: - Filter expressions are made up of one or more restrictions. - Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `EQUALS (=)` operator. Supported fields: - `entityStatus` Examples: - All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"partners\": [ { object (/display-video/api/reference/rest/v1/partners#Partner) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partners[]` | `object (`[Partner](/display-video/api/reference/rest/v1/partners#Partner)`)` The list of partners. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/display-video/api/reference/rest/v1/partners/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `partners.list` method to retrieve the next page of results. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
