Method: advertisers.reachForecast.retrievePlannableUserInterests

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

בקשת HTTP

GET https://displayvideo.googleapis.com/v4/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 הוא Open Auction (מכרז פתוח). פורמט: customers/{customerId}/userLists/{user_list_id}