Method: sellers.adUnits.list

Listet Anzeigenblöcke auf.

  • Beispiel: GET /v1/sellers/seller111/adUnits
  • Gibt eine Liste von Anzeigenblöcken und ein Token zurück, um bei Erfolg die nächste Seite abzurufen.
  • Gibt den Fehlercode PERMISSION_DENIED zurück, wenn der Nutzer keinen Zugriff auf den Verkäufer hat oder die Verkäufer-ID nicht vorhanden ist.
  • Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn Verkäufer eine ungültige Seitengröße oder ein ungültiges Seitentoken angeben.

HTTP-Anfrage

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Verkäufer, dem diese Sammlung von Anzeigenblöcken gehört Format: Verkäufer/{Verkäufer}

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl der Elemente, die zurückzugeben sind. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Die maximal zulässige Anzahl von Anzeigenblöcken beträgt 1.000. werden die Werte über 1.000 in 1.000 geändert. Wenn Sie nichts angeben, werden maximal 1.000 Anzeigenblöcke zurückgegeben.
pageToken

string

Der Wert "nextPageToken" wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.
filter

string

Der Listenfilter. Unterstützt derzeit die Filterung nach externen IDs und Status mit der Syntax: „externalId = [EXTERNAL_ID]“ und „state = [STATE]“. Mit den logischen Operatoren AND und OR können Filter verkettet werden. AD_UNIT_STATE_DELETED kann nicht zum Anzeigen gelöschter Anzeigenblöcke verwendet werden. Verwenden Sie stattdessen showDeleted.
orderBy

string

Die Reihenfolge nach String, mit der die Sortierreihenfolge der Ergebnisse festgelegt wird. Derzeit wird die Sortierung nach updateTime unterstützt. Geben Sie „updateTime“ an. , um die Ergebnisse in aufsteigender Reihenfolge nach updateTime sortiert zu erhalten, oder nach „updateTime desc“. für die absteigende Reihenfolge.
showDeleted

boolean

Gibt an, ob vorläufig gelöschte Anzeigenblöcke zurückgegeben werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht für InventoryService.ListAdUnits.

JSON-Darstellung 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Felder
adUnits[]

object (AdUnit)

Die Liste der Anzeigenblöcke.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im nachfolgenden Aufruf der Methode adUnits.list im Feld pageToken, um die nächste Ergebnisseite abzurufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.