Method: advertisers.reachForecast.retrievePlannableProducts

Truy xuất danh sách các sản phẩm có thể lên kế hoạch cho một vị trí.

Yêu cầu HTTP

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

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ê các sản phẩm có thể lập kế hoạch.

Tham số truy vấn

Tham số
plannableLocationId

string

Bắt buộc. Mã của vị trí 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.retrievePlannableProducts

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 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Trường
productMetadata[]

object (ProductMetadata)

Chỉ có đầu ra. Danh sách siêu dữ liệu sản phẩm cho thấy các khả năng nhắm mục tiêu.

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.

ProductMetadata

Siêu dữ liệu cho một sản phẩm có thể lập kế hoạch.

Biểu diễn dưới dạng JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Trường
plannableProductDescription

string

Chỉ có đầu ra. Nội dung mô tả dạng văn bản thuần tuý về sản phẩm quảng cáo.
plannableProductCode

string

Chỉ có đầu ra. Mã sản phẩm có thể lập kế hoạch (ví dụ: "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

Chỉ có đầu ra. Các khả năng nhắm mục tiêu có sẵn cho sản phẩm này.
displayName

string

Chỉ có đầu ra. Tên được liên kết với sản phẩm quảng cáo. Ví dụ: "Chiến dịch thúc đẩy lượt xem video".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Chỉ có đầu ra. Các thuộc tính cốt lõi của sản phẩm này.

PlannableTargeting

Khả năng nhắm mục tiêu cho một sản phẩm nhất định.

Biểu diễn dưới dạng JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Trường
ageRanges[]

enum (PlannableAgeRange)

Chỉ có đầu ra. Độ tuổi được phép lập kế hoạch cho sản phẩm. Tiêu chí nhắm mục tiêu thực tế được tính bằng cách liên kết phạm vi độ tuổi này với tiêu chí nhắm mục tiêu theo độ tuổi tiêu chuẩn của Google.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Chỉ có đầu ra. Các kiểu kết hợp vị trí có thể nhắm đến cho sản phẩm quảng cáo.
genders[]

enum (Gender)

Chỉ có đầu ra. Giới tính có thể nhắm đến cho sản phẩm quảng cáo.
networks[]

enum (PlannableNetwork)

Chỉ có đầu ra. Các mạng có thể nhắm đến cho sản phẩm quảng cáo.
devices[]

enum (DeviceType)

Chỉ có đầu ra. Các thiết bị có thể nhắm đến cho sản phẩm quảng cáo.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Chỉ có đầu ra. Nhóm YouTube Chọn lọc có thể nhắm đến cho sản phẩm quảng cáo.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Chỉ có đầu ra. Nhóm YouTube Chọn lọc mặc định cho sản phẩm này (nếu có).

SurfaceTargetingCombinations

Quy tắc nhắm mục tiêu theo nền tảng.

Biểu diễn dưới dạng JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Trường
availableSurfaceTypes[]

enum (PlannableSurface)

Chỉ có đầu ra. Các loại nền tảng có sẵn.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Chỉ có đầu ra. Các tổ hợp hợp lệ của những nền tảng có thể được chọn cùng nhau.
defaultSurfaceTypes[]

enum (PlannableSurface)

Chỉ có đầu ra. Các loại vị trí mặc định cho sản phẩm này.

SurfaceTargetingCombination

Một tổ hợp hợp lệ của các nền tảng.

Biểu diễn dưới dạng JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Trường
choices[]

enum (PlannableSurface)

Chỉ có đầu ra. Sự kết hợp giữa các nền tảng.

YouTubeSelectLineUp

Nhóm YouTube Chọn lọc có thể lập kế hoạch để nhắm đến sản phẩm.

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

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của Nhóm YouTube Chọn lọc.
displayName

string

Chỉ có đầu ra. Tên hiển thị của Nhóm YouTube Chọn lọc.

PlannableProductCoreAttributes

Thuộc tính cốt lõi của một sản phẩm có thể lập kế hoạch.

Biểu diễn dưới dạng JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Trường
productCategory

enum (PlannableProductCategory)

Chỉ có đầu ra. Danh mục sản phẩm.
buyingMethod

enum (PlannableBuyingMethod)

Chỉ có đầu ra. Phương thức mua.
costModel

enum (PlannableCostModel)

Chỉ có đầu ra. Mô hình chi phí.

PlannableBuyingMethod

Phương thức mua của một sản phẩm có thể lập kế hoạch.

Enum
PLANNABLE_BUYING_METHOD_UNSPECIFIED Chưa chỉ định.
PLANNABLE_BUYING_METHOD_AUCTION Phiên đấu giá.
PLANNABLE_BUYING_METHOD_RESERVATION Đặt trước.

PlannableCostModel

Mô hình chi phí của một sản phẩm có thể lập kế hoạch.

Enum
PLANNABLE_COST_MODEL_UNSPECIFIED Chưa chỉ định.
PLANNABLE_COST_MODEL_CPM tối đa.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC CPC.
PLANNABLE_COST_MODEL_CPA T.đa.