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/v16: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à pianificate 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 i metadati di pianificazione e targeting correlati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina 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 cui verranno riportate le metriche di traffico.

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

enum (ReachPlanAgeRange)

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

object (GenderInfo)

Generi disponibili per il targeting 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 registrate quando viene selezionato il targeting MOBILE per CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER e GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Reti disponibili per il targeting per il prodotto pubblicitario.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Selezioni YouTube Select disponibili per il targeting per il prodotto pubblicitario.
surfaceTargeting

object (SurfaceTargetingCombinations)

Combinazioni di superfici 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.

SurfaceTargetingCombinations

Mostra le combinazioni di targeting disponibili per un prodotto pubblicitario.

Rappresentazione JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Campi
defaultTargeting

object (SurfaceTargeting)

Targeting predefinito della piattaforma applicato al prodotto pubblicitario.
availableTargetingCombinations[]

object (SurfaceTargeting)

Combinazioni target della piattaforma disponibili per il prodotto pubblicitario.