Method: listPlannableProducts

Gibt die Liste der pro Standort planbaren YouTube-Anzeigenformate mit zulässiger Ausrichtung zurück

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v15:listPlannableProducts

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "plannableLocationId": string
}
Felder
plannableLocationId

string

Erforderlich. ID des ausgewählten Standorts für die Planung Verwenden Sie ReachPlanService.ListPlannableLocations, um die verfügbaren planbaren Standort-IDs aufzulisten.

Antworttext

Eine Antwort mit allen verfügbaren Produkten.

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

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

object (ProductMetadata)

Die Liste der Produkte, die für die Planung verfügbar sind, und zugehörige Targeting-Metadaten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

ProductMetadata

Die Metadaten, die mit einem verfügbaren planbaren Produkt verknüpft sind.

JSON-Darstellung
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Felder
plannableProductName

string

Der dem Anzeigenprodukt zugewiesene Name.

plannableTargeting

object (PlannableTargeting)

Das zulässige planbare Targeting für dieses Produkt.

plannableProductCode

string

Der mit dem Anzeigenprodukt verknüpfte Code (z. B. BUMPER, TRUEVIEW_IN_STREAM). Verwenden Sie ReachPlanService.ListPlannableProducts, um die verfügbaren planbaren Produktcodes aufzulisten.

PlannableTargeting

Das Targeting, für das Traffic-Messwerte erfasst werden.

JSON-Darstellung
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
Felder
ageRanges[]

enum (ReachPlanAgeRange)

Zulässige planbare Altersgruppen für das Produkt, für das Messwerte erfasst werden. Die tatsächliche Ausrichtung wird berechnet, indem diese Altersgruppe den standardmäßigen allgemeinen.AgeRangeInfo-Werten von Google zugeordnet wird.

genders[]

object (GenderInfo)

Geschlechter, auf die ein Targeting für das Anzeigenprodukt möglich ist.

devices[]

object (DeviceInfo)

Targeting-fähige Geräte für das Anzeigenprodukt. Die Ausrichtung auf TABLET-Geräte wird automatisch auf die gemeldeten Messwerte angewendet, wenn für die Produkte CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER und GOOGLE_PREFERRED_SHORT die Ausrichtung MOBILE ausgewählt ist.

networks[]

enum (ReachPlanNetwork)

Für das Anzeigenprodukt geeignete Netzwerke, auf die ein Targeting möglich ist.

youtubeSelectLineups[]

object (YouTubeSelectLineUp)

YouTube Select-Pakete, für die eine Ausrichtung möglich ist, sind für das Anzeigenprodukt verfügbar.

surfaceTargeting

object (SurfaceTargetingCombinations)

Für das Anzeigenprodukt verfügbare Oberflächenkombinationen, für die ein Targeting möglich ist

YouTubeSelectLineUp

Ein YouTube Select-Paket zum Planen von Produkten für die Produktausrichtung.

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

string (int64 format)

Die ID des YouTube Select-Pakets.

lineupName

string

Der eindeutige Name des YouTube Select-Pakets.

SurfaceTargetingCombinations

Die Kombinationen für die Ausrichtung auf die Oberfläche, die für ein Anzeigenprodukt verfügbar sind.

JSON-Darstellung
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Felder
defaultTargeting

object (SurfaceTargeting)

Standardmäßiges Oberflächen-Targeting, das auf das Anzeigenprodukt angewendet wird.

availableTargetingCombinations[]

object (SurfaceTargeting)

Verfügbare Kombinationen der Oberflächenausrichtung für das Anzeigenprodukt.