Method: advertisers.reachForecast.retrievePlannableUserInterests

Tahmin için kullanılabilen Google kitlelerini (kullanıcı ilgi alanları) alır.

HTTP isteği

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

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

Yol parametreleri

Parametreler
advertiserId

string (int64 format)

Zorunlu. Planlanabilir kullanıcı ilgi alanlarının listeleneceği reklamverenin kimliği.

Sorgu parametreleri

Parametreler
productCategory

enum (PlannableProductCategory)

Zorunlu. Planlanabilir kullanıcı ilgi alanlarının alınacağı ürün kategorisi.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

reachForecast.retrievePlannableUserInterests için yanıt.

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

JSON gösterimi 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Alanlar
plannableUserInterests[]

object (PlannableUserInterest)

Planlanabilir kullanıcı ilgi alanlarının (Google kitleleri) 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.

PlannableUserInterest

Hedefleme için kullanılan, planlanabilir bir kullanıcı ilgi alanı.

JSON gösterimi 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Alanlar
userInterestDisplayName

string

Yalnızca çıkış. İlgi alanının görünen adı (örneğin, "Doğa Tutkunları").
userInterestPath

string

Yalnızca çıkış. İlgi alanının kategori yolu.
userInterestType

string

Yalnızca çıkış. Kitle türü (ör. "AFFINITY", "IN_MARKET").
userInterest

object (UserInterest)

Yalnızca çıkış. Kullanıcı ilgi alanının tanımlayıcısı.

İstekle belirtilen [productCategory][] alanı, nesnede doldurulan alanı belirler.

  • "YouTube" için [userInterestCategory][] doldurulur.
  • [userInterestUserList][] "Herkesin katılabileceği açık artırma" için doldurulur.

Kullanıcı İlgi Alanı

Kullanıcı ilgi alanının tanımlayıcısı.

JSON gösterimi 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Alanlar
userInterestCategory

string

Yalnızca çıkış. İlgi alanı kategorisinin kaynak adı. productCategory "YouTube" olduğunda doldurulur. Biçim: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Yalnızca çıkış. Kullanıcı listesinin kaynak adı. productCategory "Herkesin Katılabileceği Açık Artırma" olduğunda doldurulur. Biçim: customers/{customerId}/userLists/{user_list_id}