W przypadku każdego nowego elementu zamówienia musisz zadeklarować, czy będzie on wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i interfejsu Display & Video 360 API, które nie zawierają deklaracji, zakończy się niepowodzeniem. Więcej informacji znajdziesz na naszej stronie dotyczącej wycofywania.
Wymagane. Identyfikator kanału nadrzędnego, do którego należą żądane witryny.
Parametr zbiorczy owner. Wymagane. Identyfikuje podmiot DV360, który 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ślona, 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 zbiorczy owner. Wymagane. Identyfikuje podmiot DV360, który 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:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-09 UTC."],[],["This document outlines how to retrieve a list of sites within a channel using a `GET` HTTP request. The request URL requires `channelId` and either `partnerId` or `advertiserId` as path parameters to specify the owning entity. Query parameters, including `pageSize`, `pageToken`, `orderBy`, and `filter`, allow for result customization. The request body must be empty and requires OAuth 2.0 authorization. A successful response returns a `ListSitesResponse` instance containing the requested sites.\n"],null,[]]