À partir du 8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre page sur les abandons de compatibilité.
Taille de la page demandée. Doit être compris entre 1 et 200. Si aucune valeur n'est spécifiée, la valeur par défaut est 100. Renvoie le code d'erreur INVALID_ARGUMENT si une valeur non valide est spécifiée.
pageToken
string
Jeton identifiant une page de résultats que le serveur doit renvoyer. En règle générale, il s'agit de la valeur de nextPageToken renvoyée par l'appel précédent à la méthode channels.list. Si aucune valeur n'est spécifiée, la première page de résultats est renvoyée.
orderBy
string
Champ selon lequel la liste doit être triée. Les valeurs acceptées sont les suivantes :
displayName (par défaut)
channelId
Par défaut, l'ordre de tri est croissant. Pour indiquer un champ dans l'ordre décroissant, vous devez ajouter le suffixe " desc" au nom du champ. Exemple : displayName desc
filter
string
Permet de filtrer par champs de chaîne.
Syntaxe acceptée:
Les expressions de filtre pour le canal ne peuvent contenir qu'une restriction au maximum.
Une restriction se présente sous la forme {field} {operator} {value}.
Tous les champs doivent utiliser l'opérateur HAS (:).
Champs pris en charge:
displayName
Exemples :
Toutes les chaînes dont le nom à afficher contient "google": displayName : "google".
La longueur de ce champ ne doit pas dépasser 500 caractères.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eThe Display & Video 360 API v1 has been sunset and this page documents the \u003ccode\u003echannels.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThis method allows partners or advertisers to retrieve a list of their channels using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include \u003ccode\u003epartnerId\u003c/code\u003e or \u003ccode\u003eadvertiserId\u003c/code\u003e to specify ownership, and options for pagination, sorting, and filtering.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will contain a \u003ccode\u003eListChannelsResponse\u003c/code\u003e object with the requested channel information.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to list channels for a partner or advertiser using the Display & Video 360 API. The `GET` request to `https://displayvideo.googleapis.com/v1/partners/{partnerId}/channels` retrieves the list. Users can specify `partnerId`, `advertiserId`, `pageSize`, `pageToken`, `orderBy`, and `filter` parameters to customize results. The request body should be empty. The response includes a list of channels, following the `ListChannelsResponse` format. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: partners.channels.list\n\n| Display \\& Video 360 API v1 has been sunset.\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- [Authorization Scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists channels for a partner or advertiser.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v1/partners/{partnerId}/channels`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the channels. |\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`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\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/ListChannelsResponse#FIELDS.next_page_token) returned from the previous call to `channels.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` (default) - `channelId` The default sorting order is ascending. To specify descending order for a field, a suffix \" desc\" should be added to the field name. Example: `displayName desc`. |\n| `filter` | `string` Allows filtering by channel fields. Supported syntax: - Filter expressions for channel can only contain at most one restriction. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `HAS (:)` operator. Supported fields: - `displayName` Examples: - All channels for which the display name contains \"google\": `displayName : \"google\"`. 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| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the channels. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListChannelsResponse](/display-video/api/reference/rest/v1/ListChannelsResponse).\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)."]]
