Method: listPlannableProducts

İzin verilen hedeflemeye sahip konuma göre planlanabilir YouTube reklam biçimlerinin listesini döndürür.

Atılan hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "plannableLocationId": string
}
Alanlar
plannableLocationId

string

Zorunlu. Planlama için seçilen konumun kimliği. Planlanabilir mevcut konum kimliklerini listelemek için ReachPlanService.ListPlannableLocations değerini kullanın.

Yanıt gövdesi

Mevcut tüm ürünleri içeren bir yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Alanlar
productMetadata[]

object (ProductMetadata)

Planlama için kullanılabilecek ürünlerin listesi ve ilgili hedefleme meta verileri.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

ProductMetadata

Planlanabilir mevcut bir ürünle ilişkili meta veriler.

JSON gösterimi 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Alanlar
plannableProductName

string

Reklam ürünüyle ilişkilendirilen ad.
plannableTargeting

object (PlannableTargeting)

Bu ürün için izin verilen planlanabilir hedefleme.
plannableProductCode

string

Reklam ürünüyle ilişkilendirilen kod (örneğin: BUMPER, TRUEVIEW_IN_STREAM). Planlanabilir mevcut ürün kodlarını listelemek için ReachPlanService.ListPlannableProducts değerini kullanın.

PlannableTargeting

Trafik metriklerinin raporlanacağı hedefleme.

JSON gösterimi 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ]
}
Alanlar
ageRanges[]

enum (ReachPlanAgeRange)

Metriklerin raporlanacağı ürün için izin verilen planlanabilir yaş aralıkları. Gerçek hedefleme, bu yaş aralığı standart Google Common.AgeRangeInfo değerleriyle eşlenerek hesaplanır.
genders[]

object (GenderInfo)

Reklam ürünü için hedeflenebilir cinsiyetler.
devices[]

object (DeviceInfo)

Reklam ürünü için hedeflenebilir cihazlar. CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER ve GOOGLE_PREFERRED_SHORT ürünleri için MOBİL hedefleme seçildiğinde TABLET cihaz hedeflemesi raporlanan metriklere otomatik olarak uygulanır.
networks[]

enum (ReachPlanNetwork)

Reklam ürünü için hedeflenebilir ağlar.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Reklam ürünü için hedeflenebilir YouTube Select Kanal Listeleri.

YouTubeSelectLineUp

Ürün hedefleme için planlanabilir bir YouTube Select kanal listesi.

JSON gösterimi 
{
  "lineupId": string,
  "lineupName": string
}
Alanlar
lineupId

string (int64 format)

YouTube Select kanal listesinin kimliği.
lineupName

string

YouTube Select Kanal Listesi'nin benzersiz adı.