Method: advertisers.reachForecast.retrievePlannableProducts

Recupera l'elenco dei prodotti che possono essere pianificati per una località.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
advertiserId

string (int64 format)

Obbligatorio. L'ID dell'inserzionista per cui elencare i prodotti pianificabili.

Parametri di query

Parametri
plannableLocationId

string

Obbligatorio. L'ID della posizione pianificabile.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per reachForecast.retrievePlannableProducts

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Campi
productMetadata[]

object (ProductMetadata)

Solo output. L'elenco dei metadati dei prodotti che mostrano le possibilità di targeting.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

ProductMetadata

Metadati per un prodotto pianificabile.

Rappresentazione JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Campi
plannableProductDescription

string

Solo output. La descrizione in testo normale del prodotto pubblicitario.
plannableProductCode

string

Solo output. Il codice prodotto pianificabile (ad es. "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

Solo output. Le funzionalità di targeting disponibili per questo prodotto.
displayName

string

Solo output. Il nome associato al prodotto pubblicitario. Ad esempio: "Campagna per visualizzazioni video".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Solo output. Attributi principali per questo prodotto.

PlannableTargeting

Funzionalità di targeting per un determinato prodotto.

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

enum (PlannableAgeRange)

Solo output. Fasce d'età pianificabili consentite per il prodotto. Il targeting effettivo viene calcolato mappando questa fascia d'età sul targeting per età standard di Google.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Solo output. Combinazioni di piattaforme selezionabili come target per il prodotto pubblicitario.
genders[]

enum (Gender)

Solo output. Generi a cui è possibile indirizzare il targeting per il prodotto pubblicitario.
networks[]

enum (PlannableNetwork)

Solo output. Reti a cui è possibile indirizzare il prodotto pubblicitario.
devices[]

enum (DeviceType)

Solo output. Dispositivi a cui è possibile indirizzare il prodotto pubblicitario.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Solo output. Le selezioni YouTube Select a cui è possibile scegliere come target per il prodotto pubblicitario.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Solo output. La selezione YouTube Select predefinita per questo prodotto, se applicabile.

SurfaceTargetingCombinations

Regole di targeting per superficie.

Rappresentazione JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Campi
availableSurfaceTypes[]

enum (PlannableSurface)

Solo output. I tipi di superficie disponibili.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Solo output. Combinazioni valide di piattaforme che possono essere selezionate insieme.
defaultSurfaceTypes[]

enum (PlannableSurface)

Solo output. I tipi di piattaforme predefiniti per questo prodotto.

SurfaceTargetingCombination

Una combinazione valida di piattaforme.

Rappresentazione JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Campi
choices[]

enum (PlannableSurface)

Solo output. La combinazione di piattaforme.

YouTubeSelectLineUp

Una selezione YouTube Select pianificabile per il targeting dei prodotti.

Rappresentazione JSON 
{
  "lineupId": string,
  "displayName": string
}
Campi
lineupId

string (int64 format)

Solo output. L'ID della selezione YouTube Select.
displayName

string

Solo output. Il nome visualizzato della selezione YouTube Select.

PlannableProductCoreAttributes

Attributi principali per un prodotto pianificabile.

Rappresentazione JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Campi
productCategory

enum (PlannableProductCategory)

Solo output. La categoria di prodotto.
buyingMethod

enum (PlannableBuyingMethod)

Solo output. Il metodo di acquisto.
costModel

enum (PlannableCostModel)

Solo output. Il modello di costo.

PlannableBuyingMethod

Il metodo di acquisto di un prodotto pianificabile.

Enum
PLANNABLE_BUYING_METHOD_UNSPECIFIED Non specificato.
PLANNABLE_BUYING_METHOD_AUCTION Asta.
PLANNABLE_BUYING_METHOD_RESERVATION Prenotazione.

PlannableCostModel

Il modello di costo di un prodotto pianificabile.

Enum
PLANNABLE_COST_MODEL_UNSPECIFIED Non specificato.
PLANNABLE_COST_MODEL_CPM max.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC massimo.
PLANNABLE_COST_MODEL_CPA diminuito del 4%.