Od 8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej stronie dotyczącej wycofania.
Wymagany. Identyfikator kanału nadrzędnego, do którego należą żądane witryny.
Parametr unii owner. Wymagany. Identyfikuje jednostkę DV360, która jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości:
Identyfikator partnera, który jest właścicielem kanału nadrzędnego.
Parametry zapytania
Parametry
pageSize
integer
Żądany rozmiar strony. Wartość musi mieścić się w przedziale od 1 do 10000. Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna 100. Jeśli podano nieprawidłową wartość, zwraca kod błędu INVALID_ARGUMENT.
pageToken
string
Token identyfikujący stronę wyników, którą serwer powinien zwrócić.
Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody sites.list. Jeśli nie zostanie określony, zwracana będzie pierwsza strona wyników.
orderBy
string
Pole, według którego ma być posortowana lista. Akceptowane wartości:
urlOrAppId (domyślnie)
Domyślna kolejność sortowania to rosnąca. Aby określić kolejność malejącą dla pola, do nazwy pola należy dodać sufiks „ desc”. Przykład: urlOrAppId desc.
filter
string
Umożliwia filtrowanie według pól witryny.
Obsługiwana składnia:
Wyrażenia filtra do pobierania witryn mogą zawierać maksymalnie 1 ograniczenie.
Ograniczenie ma postać {field} {operator} {value}.
Wszystkie pola muszą używać operatora HAS (:).
Obsługiwane pola:
urlOrAppId
Przykłady:
Wszystkie witryny, których adres URL lub identyfikator aplikacji zawiera „google”: urlOrAppId : "google"
Długość tego pola nie powinna przekraczać 500 znaków.
Parametr unii owner. Wymagany. Identyfikuje jednostkę DV360, która jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości:
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eLists sites within a given Display & Video 360 channel using the \u003ccode\u003esites.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the parent channel's ID and the owner (either partner or advertiser) using path or query parameters.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering and sorting of results based on criteria such as URL or app ID, page size, and order.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of sites along with pagination details in the response for accessing subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope for accessing this functionality.\u003c/p\u003e\n"]]],[],null,["# Method: partners.channels.sites.list\n\n| Display \\& Video 360 API v2 has 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 sites in a channel.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v2/partners/{partnerId}/channels/{channelId}/sites`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `channelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent channel to which the requested sites belong. |\n| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent channel. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `10000`. 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/v2/ListSitesResponse#FIELDS.next_page_token) returned from the previous call to `sites.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: - `urlOrAppId` (default) The default sorting order is ascending. To specify descending order for a field, a suffix \" desc\" should be added to the field name. Example: `urlOrAppId desc`. |\n| `filter` | `string` Allows filtering by site fields. Supported syntax: - Filter expressions for site retrieval 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: - `urlOrAppId` Examples: - All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"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| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent channel. |\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 [ListSitesResponse](/display-video/api/reference/rest/v2/ListSitesResponse).\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)."]]
