Method: advertisers.reachForecast.retrievePlannableUserInterests

تعرض هذه السمة شرائح جمهور Google (اهتمامات المستخدمين) المتاحة للتوقّع.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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][] في "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}