Method: advertisers.reachForecast.retrievePlannableUserInterests

مخاطبان گوگل (علایق کاربر) موجود برای پیش‌بینی را بازیابی می‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
advertiserId

string ( int64 format)

الزامی. شناسه تبلیغ‌کننده برای فهرست کردن علایق قابل برنامه‌ریزی کاربر.

پارامترهای پرس و جو

پارامترها
productCategory

enum ( PlannableProductCategory )

الزامی. دسته‌بندی محصول برای بازیابی علایق قابل برنامه‌ریزی کاربر.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخ برای reachForecast.retrievePlannableUserInterests.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
فیلدها
plannableUserInterests[]

object ( PlannableUserInterest )

فهرست علایق قابل برنامه‌ریزی کاربران (مخاطبان گوگل).

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

PlannableUserInterest

یک علاقه کاربری قابل برنامه‌ریزی که برای هدف‌گیری استفاده می‌شود.

نمایش JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
فیلدها
userInterestDisplayName

string

فقط خروجی. نام نمایشی مورد علاقه، برای مثال "علاقه‌مندان به فضای باز".

userInterestPath

string

فقط خروجی. مسیر دسته‌بندی مورد نظر.

userInterestType

string

فقط خروجی. نوع مخاطب، مثلاً "AFFINITY"، "IN_MARKET".

userInterest

object ( UserInterest )

فقط خروجی. شناسه‌ی مورد نظر کاربر.

[productCategory][] که در درخواست مشخص شده است، فیلدی را که در شیء قرار می‌گیرد، تعیین می‌کند.

  • ‎[userInterestCategory][]‎ برای "Youtube" پر شده است.
  • ‎[userInterestUserList][] برای "حراج آزاد" پر شده است.

کاربرعلاقه‌مند

شناسه‌ی علاقه‌ی کاربر.

نمایش JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
فیلدها
userInterestCategory

string

فقط خروجی. نام منبع دسته‌بندی مورد علاقه. وقتی productCategory برابر با "Youtube" باشد، مقداردهی می‌شود. فرمت: customers/{customerId}/userInterests/{user_interest_id}

userInterestUserList

string

فقط خروجی. نام منبع لیست کاربران. وقتی productCategory برابر با "مزایده آزاد" باشد، پر می‌شود. فرمت: customers/{customerId}/userLists/{user_list_id}