Method: listPlannableProducts

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

Verilen hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP isteği

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

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

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

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

string

Zorunlu. Planlama için seçilen konumun kimliği. Planlanabilir 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 ve ilgili hedefleme meta verileri için kullanılabilecek ürünlerin listesi.

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). Kullanılabilir planlanabilir ürün kodlarını listelemek için ReachPlanService.ListPlannableProducts özelliğini 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)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
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 MOBILE 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
surfaceTargeting

object (SurfaceTargetingCombinations)

Reklam ürünü için hedeflenebilir yüzey kombinasyonları.

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 Listesi'nin kimliği.
lineupName

string

YouTube Select Kanal Listesi'nin benzersiz adı.

SurfaceTargetingCombinations

Bir reklam ürünü için kullanılabilen yüzey hedefleme kombinasyonları.

JSON gösterimi 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Alanlar
defaultTargeting

object (SurfaceTargeting)

Reklam ürününe uygulanan varsayılan yüzey hedefleme.
availableTargetingCombinations[]

object (SurfaceTargeting)

Reklam ürünü için kullanılabilir yüzey hedefi kombinasyonları.