Method: listPlannableProducts

Restituisce l'elenco dei formati degli annunci di YouTube pianificabili per località con targeting consentito.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "plannableLocationId": string
}
Campi
plannableLocationId

string

Obbligatorio. L'ID della località selezionata per la pianificazione. Per elencare gli ID località programmabili disponibili, utilizza ReachPlanService.ListPlannableLocations.

Corpo della risposta

Una risposta con tutti i prodotti disponibili.

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

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

object (ProductMetadata)

L'elenco di prodotti disponibili per la pianificazione e i relativi metadati di targeting.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ProductMetadata

I metadati associati a un prodotto pianificabile disponibile.

Rappresentazione JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Campi
plannableProductName

string

Il nome associato al prodotto pubblicitario.
plannableTargeting

object (PlannableTargeting)

Il targeting pianificabile consentito per questo prodotto.
plannableProductCode

string

Il codice associato al prodotto pubblicitario (ad esempio: BUMPER, TRUEVIEW_IN_STREAM). Per elencare i codici di prodotto pianificabili disponibili, utilizza ReachPlanService.ListPlannableProducts.

PlannableTargeting

Il targeting per il quale verranno riportate le metriche sul traffico.

Rappresentazione JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ]
}
Campi
ageRanges[]

enum (ReachPlanAgeRange)

Le fasce d'età pianificabili consentite per il prodotto per cui verranno incluse le metriche. Il targeting effettivo viene calcolato mappando questa fascia di età ai valori standard di Google Common.AgeRangeInfo.
genders[]

object (GenderInfo)

Generi selezionabili come target per il prodotto pubblicitario.
devices[]

object (DeviceInfo)

Dispositivi selezionabili come target per il prodotto pubblicitario. Il targeting per dispositivo TABLET viene applicato automaticamente alle metriche dei report quando è selezionato il targeting MOBILE per i prodotti CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER e GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Reti selezionabili come target per il prodotto pubblicitario.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Selezioni YouTube Select selezionabili come target per il prodotto pubblicitario.

YouTubeSelectLineUp

Una selezione YouTube Select pianificata per il targeting per prodotto.

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

string (int64 format)

L'ID della selezione YouTube Select.
lineupName

string

Il nome univoco della selezione YouTube Select.