Method: advertisers.reachForecast.retrievePlannableProducts

Bir konum için planlanabilecek ürünlerin listesini alır.

HTTP isteği

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

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

Yol parametreleri

Parametreler
advertiserId

string (int64 format)

Zorunlu. Planlanabilir ürünlerin listeleneceği reklamverenin kimliği.

Sorgu parametreleri

Parametreler
plannableLocationId

string

Zorunlu. Planlanabilir konumun kimliği.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

reachForecast.retrievePlannableProducts için 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)

Yalnızca çıkış. Hedefleme olanaklarını gösteren ürün meta verileri listesi.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

ProductMetadata

Planlanabilir bir ürünün meta verileri.

JSON gösterimi 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Alanlar
plannableProductDescription

string

Yalnızca çıkış. Reklam ürününün düz metin açıklaması.
plannableProductCode

string

Yalnızca çıkış. Planlanabilir ürün kodu (ör. "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

Yalnızca çıkış. Bu ürün için kullanılabilen hedefleme özellikleri.
displayName

string

Yalnızca çıkış. Reklam ürünüyle ilişkili ad. Örneğin: "Video Görüntüleme Kampanyası".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Yalnızca çıkış. Bu ürünün temel özellikleri.

PlannableTargeting

Belirli bir ürün için hedefleme özellikleri.

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

enum (PlannableAgeRange)

Yalnızca çıkış. Ürün için planlanabilir yaş aralıklarına izin verilir. Gerçek hedefleme, bu yaş grubunun standart Google yaş hedeflemesiyle eşlenmesiyle hesaplanır.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Yalnızca çıkış. Reklam ürünü için hedeflenebilir yüzey kombinasyonları.
genders[]

enum (Gender)

Yalnızca çıkış. Reklam ürünü için hedeflenebilir cinsiyetler.
networks[]

enum (PlannableNetwork)

Yalnızca çıkış. Reklam ürünü için hedeflenebilir ağlar.
devices[]

enum (DeviceType)

Yalnızca çıkış. Reklam ürünü için hedeflenebilir cihazlar.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Yalnızca çıkış. Reklam ürünü için hedeflenebilir YouTube Select kanal listeleri.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Yalnızca çıkış. Varsa bu ürün için varsayılan YouTube Select kanal listesi.

SurfaceTargetingCombinations

Yüzey hedefleme kuralları.

JSON gösterimi 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Alanlar
availableSurfaceTypes[]

enum (PlannableSurface)

Yalnızca çıkış. Kullanılabilir yüzey türleri.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Yalnızca çıkış. Birlikte seçilebilen geçerli yüzey kombinasyonları.
defaultSurfaceTypes[]

enum (PlannableSurface)

Yalnızca çıkış. Bu ürün için varsayılan yüzey türleri.

SurfaceTargetingCombination

Geçerli bir yüzey kombinasyonu.

JSON gösterimi 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Alanlar
choices[]

enum (PlannableSurface)

Yalnızca çıkış. Yüzeylerin kombinasyonu.

YouTubeSelectLineUp

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

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

string (int64 format)

Yalnızca çıkış. YouTube Select kanal listesinin kimliği.
displayName

string

Yalnızca çıkış. YouTube Select Kanal Listesi'nin görünen adı.

PlannableProductCoreAttributes

Planlanabilir bir ürünün temel özellikleri.

JSON gösterimi 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Alanlar
productCategory

enum (PlannableProductCategory)

Yalnızca çıkış. Ürün kategorisi.
buyingMethod

enum (PlannableBuyingMethod)

Yalnızca çıkış. Satın alma yöntemi.
costModel

enum (PlannableCostModel)

Yalnızca çıkış. Maliyet modeli.

PlannableBuyingMethod

Planlanabilir bir ürünün satın alma yöntemi.

Sıralamalar
PLANNABLE_BUYING_METHOD_UNSPECIFIED Belirtilmedi.
PLANNABLE_BUYING_METHOD_AUCTION Açık artırma.
PLANNABLE_BUYING_METHOD_RESERVATION Rezervasyon

PlannableCostModel

Planlanabilir bir ürünün maliyet modeli.

Sıralamalar
PLANNABLE_COST_MODEL_UNSPECIFIED Belirtilmedi.
PLANNABLE_COST_MODEL_CPM BGBM kullanmayı sürdürecek.
PLANNABLE_COST_MODEL_CPV GBM.
PLANNABLE_COST_MODEL_CPC düşüktür.
PLANNABLE_COST_MODEL_CPA belirlersiniz.