Method: advertisers.reachForecast.retrievePlannableUserInterests

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

طلب HTTP

GET https://displayvideo.googleapis.com/v5/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}