Method: advertisers.reachForecast.retrievePlannableProducts

Ruft die Liste der Produkte ab, die für einen Standort geplant werden können.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, für den planbare Produkte aufgelistet werden sollen.

Suchparameter

Parameter
plannableLocationId

string

Erforderlich. Die ID des planbaren Standorts.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für „reachForecast.retrievePlannableProducts“

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

JSON-Darstellung 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Felder
productMetadata[]

object (ProductMetadata)

Nur Ausgabe. Die Liste der Produktmetadaten, die Ausrichtungsmöglichkeiten aufzeigen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ProductMetadata

Metadaten für ein planbares Produkt.

JSON-Darstellung 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Felder
plannableProductDescription

string

Nur Ausgabe. Die Klartextbeschreibung des Anzeigenprodukts.
plannableProductCode

string

Nur Ausgabe. Der planbare Produktcode, z.B. „YOUTUBE_REACH_MIX“.
plannableTargeting

object (PlannableTargeting)

Nur Ausgabe. Die für dieses Produkt verfügbaren Targeting-Funktionen.
displayName

string

Nur Ausgabe. Der Name, der dem Anzeigenprodukt zugeordnet ist. Beispiel: „Videoaufruf-Kampagne“
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Nur Ausgabe. Wichtige Attribute für dieses Produkt.

PlannableTargeting

Ausrichtungsfunktionen für ein bestimmtes Produkt.

JSON-Darstellung 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Felder
ageRanges[]

enum (PlannableAgeRange)

Nur Ausgabe. Zulässige planbare Altersgruppen für das Produkt. Das tatsächliche Targeting wird berechnet, indem diese Altersgruppe dem standardmäßigen Google-Targeting nach Alter zugeordnet wird.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Nur Ausgabe. Kombinationen von Oberflächen, die für das Anzeigenprodukt als Zielvorhaben verwendet werden können.
genders[]

enum (Gender)

Nur Ausgabe. Geschlechter, auf die mit dem Anzeigenprodukt ausgerichtet werden kann.
networks[]

enum (PlannableNetwork)

Nur Ausgabe. Auf die Werbenetzwerke, die für das Anzeigenprodukt ausgerichtet werden können.
devices[]

enum (DeviceType)

Nur Ausgabe. Auf Geräte ausgerichtete Anzeigenprodukte.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Nur Ausgabe. Targeting-fähige YouTube Select-Pakete für das Anzeigenprodukt.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Nur Ausgabe. Das Standard-YouTube Select-Paket für dieses Produkt, falls zutreffend.

SurfaceTargetingCombinations

Regeln für das Targeting auf Oberflächen.

JSON-Darstellung 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Felder
availableSurfaceTypes[]

enum (PlannableSurface)

Nur Ausgabe. Die verfügbaren Oberflächentypen.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Nur Ausgabe. Gültige Kombinationen von Oberflächen, die zusammen ausgewählt werden können.
defaultSurfaceTypes[]

enum (PlannableSurface)

Nur Ausgabe. Die Standardoberflächentypen für dieses Produkt.

SurfaceTargetingCombination

Eine gültige Kombination von Oberflächen.

JSON-Darstellung 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Felder
choices[]

enum (PlannableSurface)

Nur Ausgabe. Die Kombination von Oberflächen.

YouTubeSelectLineUp

Ein planbares YouTube Select-Paket für das Produkt-Targeting.

JSON-Darstellung 
{
  "lineupId": string,
  "displayName": string
}
Felder
lineupId

string (int64 format)

Nur Ausgabe. Die ID des YouTube Select-Pakets.
displayName

string

Nur Ausgabe. Der Anzeigename des YouTube Select-Pakets.

PlannableProductCoreAttributes

Wichtige Attribute für ein planbares Produkt.

JSON-Darstellung 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Felder
productCategory

enum (PlannableProductCategory)

Nur Ausgabe. Die Produktkategorie.
buyingMethod

enum (PlannableBuyingMethod)

Nur Ausgabe. Die Kaufmethode.
costModel

enum (PlannableCostModel)

Nur Ausgabe. Das Kostenmodell.

PlannableBuyingMethod

Die Kaufmethode eines planbaren Produkts.

Enums
PLANNABLE_BUYING_METHOD_UNSPECIFIED Nicht angegeben.
PLANNABLE_BUYING_METHOD_AUCTION Auktion
PLANNABLE_BUYING_METHOD_RESERVATION Reservierung

PlannableCostModel

Das Kostenmodell eines planbaren Produkts.

Enums
PLANNABLE_COST_MODEL_UNSPECIFIED Nicht angegeben.
PLANNABLE_COST_MODEL_CPM CPM" verwendet.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC CPC
PLANNABLE_COST_MODEL_CPA CPA.