Method: advertisers.reachForecast.retrievePlannableUserInterests

Ruft Google-Zielgruppen (Nutzerinteressen) ab, die für Prognosen verfügbar sind.

HTTP-Anfrage

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, für den planbare Nutzerinteressen aufgeführt werden sollen.

Suchparameter

Parameter
productCategory

enum (PlannableProductCategory)

Erforderlich. Die Produktkategorie, für die planbare Nutzerinteressen abgerufen werden sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für „reachForecast.retrievePlannableUserInterests“.

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

JSON-Darstellung 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Felder
plannableUserInterests[]

object (PlannableUserInterest)

Die Liste der planbaren Nutzerinteressen (Google-Zielgruppen).

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

PlannableUserInterest

Ein planbares Nutzerinteresse, das für das Targeting verwendet wird.

JSON-Darstellung 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Felder
userInterestDisplayName

string

Nur Ausgabe. Der Anzeigename des Interesses, z. B. „Outdoor-Liebhaber“.
userInterestPath

string

Nur Ausgabe. Der Kategoriepfad des Interesses.
userInterestType

string

Nur Ausgabe. Der Zielgruppentyp, z.B. „AFFINITY“ oder „IN_MARKET“.
userInterest

object (UserInterest)

Nur Ausgabe. Die Kennung für das Nutzerinteresse.

Die in der Anfrage angegebene [productCategory][] bestimmt das Feld, das im Objekt ausgefüllt wird.

  • [userInterestCategory][] wird für „YouTube“ ausgefüllt.
  • [userInterestUserList][] wird für „Offene Auktion“ ausgefüllt.

UserInterest

Die Kennung für ein Nutzerinteresse.

JSON-Darstellung 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Felder
userInterestCategory

string

Nur Ausgabe. Der Ressourcenname der Interessenkategorie. Wird ausgefüllt, wenn productCategory „YouTube“ ist. Format: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Nur Ausgabe. Der Ressourcenname der Nutzerliste. Wird ausgefüllt, wenn productCategory „Offene Auktion“ ist. Format: customers/{customerId}/userLists/{user_list_id}