Method: advertisers.reachForecast.retrievePlannableUserInterests

«مخاطبان Google» (علایق کاربر) را که برای پیش‌بینی دردسترس است بازیابی می‌کند.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
advertiserId

string (int64 format)

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

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

پارامترها
productCategory

enum (PlannableProductCategory)

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

متن درخواست

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

بدنه پاسخ

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

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

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

object (PlannableUserInterest)

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

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

به محدوده 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][] is populated for "Youtube".
  • [userInterestUserList][] برای «مزایده باز» پر شده است.

UserInterest

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

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

string

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

string

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