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. Das ist die DV360-Entität, die Inhaber des übergeordneten Kanals ist. Das kann entweder ein Partner oder ein Werbetreibender sein. Für owner ist nur einer der folgenden Werte zulässig:
Die ID des Werbetreibenden, dem der übergeordnete Channel gehört.
Abfrageparameter
Parameters
pageSize
integer
Angeforderte Seitengröße. Muss zwischen 1 und 10000 liegen. Wenn keine Vorgabe erfolgt, wird standardmäßig 100 verwendet. Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn ein ungültiger Wert angegeben wurde.
pageToken
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.
In der Regel ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der sites.list-Methode zurückgegeben wurde. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben.
orderBy
string
Feld, nach dem die Liste sortiert werden soll. Akzeptable Werte sind:
urlOrAppId (Standard)
Die standardmäßige Sortierreihenfolge ist aufsteigend. Wenn ein Feld absteigend sortiert werden soll, muss 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 das Abrufen von Websites dürfen nur eine Einschränkung enthalten.
Eine Einschränkung hat das Format {field} {operator} {value}.
Alle Felder müssen den Operator HAS (:) verwenden.
Unterstützte Felder:
urlOrAppId
Beispiele:
Alle Websites, deren URL oder App-ID „google“ enthält: urlOrAppId : "google"
Die Länge dieses Feldes darf 500 Zeichen nicht überschreiten.
Union-Parameter owner. Erforderlich. Das ist die DV360-Entität, die Inhaber des übergeordneten Kanals ist. Das kann entweder ein Partner oder ein Werbetreibender sein. 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: 2024-06-11 (UTC)."],[[["Lists sites associated with a given channel within a Display & Video 360 advertiser or partner."],["Allows filtering and sorting of sites based on criteria like URL or app ID."],["Supports pagination to retrieve large lists of sites efficiently."],["Requires authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["This document outlines the process for listing sites within a channel using the Display & Video 360 API. Key actions include sending a `GET` request to a specified URL, which requires the `channelId` and either `advertiserId` or `partnerId` as path parameters. Optional query parameters, such as `pageSize`, `pageToken`, `orderBy`, and `filter`, refine the list results. The request body must be empty, and successful responses contain a `ListSitesResponse`. API authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]