Method: advertisers.reachForecast.retrievePlannableUserInterests

אחזור של קהלים ב-Google (תחומי עניין של משתמשים) שזמינים לתחזיות.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
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][] מאוכלס ב "מכרז פתוח".

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}