Method: advertisers.reachForecast.retrievePlannableUserInterests

Truy xuất Đối tượng của Google (Mối quan tâm của người dùng) có sẵn để dự báo.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
advertiserId

string (int64 format)

Bắt buộc. Mã nhận dạng của nhà quảng cáo để liệt kê những mối quan tâm có thể lập kế hoạch của người dùng.

Tham số truy vấn

Tham số
productCategory

enum (PlannableProductCategory)

Bắt buộc. Danh mục sản phẩm để truy xuất sở thích của người dùng có thể lập kế hoạch.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho reachForecast.retrievePlannableUserInterests.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Trường
plannableUserInterests[]

object (PlannableUserInterest)

Danh sách mối quan tâm của người dùng có thể lập kế hoạch (Đối tượng của Google).

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/display-video

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

PlannableUserInterest

Mối quan tâm của người dùng có thể lập kế hoạch được dùng để nhắm mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Trường
userInterestDisplayName

string

Chỉ có đầu ra. Tên hiển thị của mối quan tâm, ví dụ: "Người đam mê hoạt động ngoài trời".
userInterestPath

string

Chỉ có đầu ra. Đường dẫn danh mục của mối quan tâm.
userInterestType

string

Chỉ có đầu ra. Loại đối tượng, ví dụ: "AFFINITY", "IN_MARKET".
userInterest

object (UserInterest)

Chỉ có đầu ra. Giá trị nhận dạng cho mối quan tâm của người dùng.

[productCategory][] được chỉ định trong yêu cầu sẽ quyết định trường được điền sẵn trong đối tượng.

  • [userInterestCategory][] được điền sẵn cho "YouTube".
  • [userInterestUserList][] được điền sẵn cho "Phiên đấu giá mở".

Sở thích của người dùng

Giá trị nhận dạng cho mối quan tâm của người dùng.

Biểu diễn dưới dạng JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Trường
userInterestCategory

string

Chỉ có đầu ra. Tên tài nguyên của danh mục mối quan tâm. Được điền sẵn khi productCategory là "YouTube". Định dạng: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Chỉ có đầu ra. Tên tài nguyên của danh sách người dùng. Được điền sẵn khi productCategory là "Phiên đấu giá mở". Định dạng: customers/{customerId}/userLists/{user_list_id}