Display- und Video 360 API Version 2 wird eingestellt. Verwenden Sie Display- und Video 360 API v3. Eine Anleitung zur Migration von Version 2 zu Version 3 finden Sie in unserer Migrationsanleitung.
Erforderlich. Die ID des übergeordneten Channels, zu dem die angeforderten Websites gehören.
Union-Parameter owner. Erforderlich. Die DV360-Entität, die dem übergeordneten Kanal zugewiesen ist. Es kann sich dabei um einen Partner oder einen Werbetreibenden handeln. Für owner ist nur einer der folgenden Werte zulässig:
Die ID des Partners, dem der übergeordnete Kanal gehört.
Abfrageparameter
Parameter
pageSize
integer
Angeforderte Seitengröße. Muss zwischen 1 und 10000 liegen. Wenn nicht angegeben, wird standardmäßig 100 verwendet. Wenn ein ungültiger Wert angegeben wird, wird der Fehlercode INVALID_ARGUMENT zurückgegeben.
pageToken
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.
Normalerweise ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der sites.list-Methode zurückgegeben wurde. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben.
orderBy
string
Feld, nach dem die Liste sortiert werden soll. Akzeptable Werte sind:
urlOrAppId (Standard)
Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie ein Feld absteigend sortieren möchten, sollte dem Feldnamen das Suffix „desc“ hinzugefügt werden. Beispiel: urlOrAppId desc.
filter
string
Ermöglicht das Filtern nach Websitefeldern.
Unterstützte Syntax:
Filterausdrücke für den Websiteabruf dürfen höchstens eine Einschränkung enthalten.
Eine Einschränkung hat das Format {field} {operator} {value}.
Für alle Felder muss der Operator HAS (:) verwendet werden.
Unterstützte Felder:
urlOrAppId
Beispiele:
Alle Websites, deren URL oder App-ID „google“ enthält: urlOrAppId : "google"
Dieses Feld darf maximal 500 Zeichen lang sein.
Weitere Informationen finden Sie in unserem Leitfaden zu LIST-Anfragen.
Union-Parameter owner. Erforderlich. Die DV360-Entität, die dem übergeordneten Kanal zugewiesen ist. Es kann sich dabei um einen Partner oder einen Werbetreibenden handeln. Für owner ist nur einer der folgenden Werte zulässig:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-02-25 (UTC)."],[[["Lists sites within a given Display & Video 360 channel using a `GET` request."],["Requires specifying the parent channel's ID and the owning partner or advertiser ID."],["Allows filtering and sorting results with query parameters like `filter` and `orderBy`."],["Supports pagination with `pageSize` and `pageToken` to retrieve large result sets."],["Needs authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["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"]]