REST Resource: exchanges.orders.products

Tài nguyên: Sản phẩm

Sản phẩm

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "externalDealId": string,
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "updateTime": string,
  "startTime": string,
  "endTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "creativeConfig": [
    {
      object (CreativeConfig)
    }
  ],
  "makegood": boolean,
  "makegoodDetails": {
    object (MakegoodDetails)
  },
  "creativeSource": enum (CreativeSource),
  "mediumType": enum (MediumType),
  "audienceTargetingConfig": {
    object (AudienceTargetingConfig)
  },
  "targetingCriteria": {
    object (TargetingCriteria)
  },
  "forecastResult": {
    object (ForecastResult)
  },
  "errorDetails": {
    object (ErrorDetails)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "program": string,
  "buyerCustomParameters": {
    string: string,
    ...
  },
  "etag": string
}
Trường
name

string

Tên tài nguyên tương đối của sản phẩm. Do máy chủ tạo. Ví dụ: "exchanges/1234/orders/5678/products/abc". Chỉ có đầu ra.
displayName

string

Tên hiển thị của sản phẩm.

Phải được mã hoá theo UTF-8 với kích thước tối đa là 240 byte. Bắt buộc.
externalDealId

string

Mã nhận dạng bên ngoài. Đây là mã giao dịch trên hệ thống trao đổi. Tối đa 100 ký tự. Các ký tự được phép là chữ và số, dấu gạch dưới, dấu gạch ngang và dấu chấm. Phải là duy nhất cho tất cả sản phẩm. Bắt buộc.
transactionType

enum (TransactionType)

Loại giao dịch sản phẩm. Bắt buộc.
pricingType

enum (PricingType)

Loại giá cho sản phẩm. Bắt buộc.
updateTime
(deprecated)

string (Timestamp format)

Dấu thời gian khi sản phẩm được cập nhật lần gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Thời điểm sản phẩm này bắt đầu hoạt động. Phải sớm hơn endTime. Thời gian bắt đầu không được quá 1 năm trong tương lai. Bắt buộc.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Thời điểm sản phẩm này không còn hoạt động. Không được muộn hơn năm 2036. Bắt buộc.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
rateDetails

object (RateDetails)

Chi tiết về giá. Bắt buộc.
creativeConfig[]

object (CreativeConfig)

Yêu cầu về mẫu quảng cáo cho một sản phẩm. Bắt buộc đối với sản phẩm có loại giao dịch đặt trước.
makegood
(deprecated)

boolean

Cho biết liệu một sản phẩm có phải là sản phẩm đền bù hay không.
makegoodDetails
(deprecated)

object (MakegoodDetails)

Thông tin chi tiết về quảng cáo đền bù cho một sản phẩm. Bắt buộc khi sản phẩm là quảng cáo đền bù.
creativeSource

enum (CreativeSource)

Nguồn mẫu quảng cáo cho một sản phẩm. Không bắt buộc, mặc định là CREATIVE_SOURCE_ADVERTISER. Không thể thay đổi sau khi tạo sản phẩm.
mediumType

enum (MediumType)

Loại phương tiện cho một sản phẩm. Giá trị mặc định là DIGITAL nếu không được chỉ định để tương thích ngược. Không thể thay đổi sau khi tạo sản phẩm.
audienceTargetingConfig

object (AudienceTargetingConfig)

Không bắt buộc. Cấu hình nhắm mục tiêu theo đối tượng được áp dụng ở cấp giao dịch trên sàn giao dịch.
targetingCriteria

object (TargetingCriteria)

Chỉ có đầu ra. Tài liệu tham khảo về tiêu chí nhắm mục tiêu sản phẩm. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.
forecastResult

object (ForecastResult)

Kết quả dự báo về sản phẩm. Bắt buộc khi tiêu chí nhắm mục tiêu không trống và thông tin dự báo không được cung cấp. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.
errorDetails

object (ErrorDetails)

Bạn phải nêu rõ thông tin chi tiết về lỗi khi không thể cập nhật một số trường sản phẩm. Bắt buộc khi không thể cung cấp kết quả dự đoán do tiêu chí nhắm mục tiêu hoặc không thể cập nhật sản phẩm. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.
frequencyCap

object (FrequencyCap)

Chỉ có đầu ra. Giới hạn tần suất do người mua chọn. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.
program

string

Chỉ có đầu ra. Chương trình mà người mua đã tạo giao dịch tức thì. Để trống cho quy trình thông thường của sàn giao dịch. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.
buyerCustomParameters

map (key: string, value: string)

Chỉ có đầu ra. Các tham số khoá/giá trị tuỳ chỉnh do người mua đặt trên yêu cầu giao dịch tức thì. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag

string

Một etag cần được chỉ định khi cập nhật sản phẩm. Bạn chỉ cần chỉ định trường này cho một bản cập nhật nếu trường etag không trống. Chỉ áp dụng cho các Kịch bản giao dịch tức thì.

CreativeConfig

Cấu hình yêu cầu về mẫu quảng cáo cho một sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "creativeType": enum (CreativeType),
  "dimensionCreativeConfig": {
    object (DimensionCreativeConfig)
  },
  "durationCreativeConfig": {
    object (DurationCreativeConfig)
  }
}
Trường
creativeType

enum (CreativeType)

Loại mẫu quảng cáo. Bắt buộc.
dimensionCreativeConfig

object (DimensionCreativeConfig)

Cấu hình cho mẫu quảng cáo hiển thị. Trường này không được hỗ trợ cho mẫu quảng cáo gốc (CREATIVE_TYPE_NATIVE).
durationCreativeConfig

object (DurationCreativeConfig)

Cấu hình cho mẫu quảng cáo dạng video.

CreativeType

Các loại mẫu quảng cáo có thể có.

Enum
CREATIVE_TYPE_UNSPECIFIED Chưa chỉ định loại mẫu quảng cáo. Giá trị nhập không hợp lệ.
CREATIVE_TYPE_DISPLAY Loại mẫu quảng cáo hiển thị.
CREATIVE_TYPE_VIDEO Loại mẫu quảng cáo dạng video.
CREATIVE_TYPE_AUDIO Loại mẫu quảng cáo dạng âm thanh.
CREATIVE_TYPE_NATIVE Loại mẫu quảng cáo gốc. Tính năng này không được hỗ trợ cho các sản phẩm thuộc loại giao dịch RESERVED.

DimensionCreativeConfig

Kích thước mẫu quảng cáo hiển thị tính bằng pixel.

Biểu diễn dưới dạng JSON 
{
  "width": integer,
  "height": integer
}
Trường
width

integer

Chiều rộng của mẫu quảng cáo hiển thị. Bắt buộc.
height

integer

Chiều cao của mẫu quảng cáo hiển thị. Bắt buộc.

DurationCreativeConfig

Cấu hình cho mẫu quảng cáo trong thời lượng.

Biểu diễn dưới dạng JSON 
{
  "duration": string,
  "durationMatchType": enum (DurationMatchType),
  "skippableMatchType": enum (SkippableMatchType)
}
Trường
duration

string (Duration format)

Thời lượng của mẫu quảng cáo dạng video (tính bằng giây). Bắt buộc

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
durationMatchType

enum (DurationMatchType)

Tiêu chí so khớp thời lượng.
skippableMatchType

enum (SkippableMatchType)

Loại có thể bỏ qua của mẫu quảng cáo dạng video.

DurationMatchType

Tiêu chí so khớp cho thời lượng mẫu quảng cáo dạng video.

Enum
DURATION_MATCH_TYPE_UNSPECIFIED Tiêu chí so khớp thời lượng không được chỉ định hoặc không xác định trong phiên bản này. Giá trị nhập không hợp lệ.
DURATION_MATCH_TYPE_EQUAL_TO Thời lượng của mẫu quảng cáo phải giống với thời lượng bắt buộc.
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO Thời lượng của mẫu quảng cáo phải bằng hoặc ngắn hơn thời lượng bắt buộc.

SkippableMatchType

Tiêu chí so khớp cho biết liệu mẫu quảng cáo dạng video có thể bỏ qua hay không.

Enum
SKIPPABLE_MATCH_TYPE_UNSPECIFIED Loại có thể bỏ qua không được chỉ định hoặc không xác định trong phiên bản này. Giá trị nhập không hợp lệ.
SKIPPABLE_MATCH_TYPE_SKIPPABLE Mẫu quảng cáo cần có thể bỏ qua.
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE Mẫu quảng cáo không được bỏ qua được.
SKIPPABLE_MATCH_TYPE_ANY Mẫu quảng cáo có thể bỏ qua hoặc không thể bỏ qua.

MakegoodDetails

Cấu hình cho thông tin chi tiết về quảng cáo đền bù.

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

string

Mã giao dịch bên ngoài ban đầu yêu cầu quảng cáo đền bù. Tối đa 100 ký tự. Các ký tự được phép là chữ và số, dấu gạch dưới, dấu gạch ngang và dấu chấm. Bắt buộc.
reason

string

Lý do quảng cáo đền bù do người bán đưa ra. Tối đa 250 ký tự. Bắt buộc.

CreativeSource

Nguồn mẫu quảng cáo; nơi mẫu quảng cáo sẽ được phân phát.

Enum
CREATIVE_SOURCE_UNSPECIFIED Nguồn mẫu quảng cáo không được chỉ định hoặc không xác định trong phiên bản này. Giá trị nhập không hợp lệ.
CREATIVE_SOURCE_ADVERTISER Mẫu quảng cáo sẽ do DV360 phân phát.
CREATIVE_SOURCE_PUBLISHER Mẫu quảng cáo sẽ do nhà xuất bản phân phát. Mẫu quảng cáo do nhà xuất bản lưu trữ hiện không được hỗ trợ; mọi yêu cầu cố gắng đặt nguồn mẫu quảng cáo thành CREATIVE_SOURCE_PUBLISHER sẽ không thành công.

AudienceTargetingConfig

Cấu hình cho tiêu chí nhắm mục tiêu theo đối tượng.

Biểu diễn dưới dạng JSON 
{
  "audienceType": enum (AudienceType)
}
Trường
audienceType

enum (AudienceType)

Loại đối tượng. Bắt buộc.

AudienceType

Loại đối tượng.

Enum
AUDIENCE_TYPE_UNSPECIFIED Loại đối tượng chưa được chỉ định. Không hợp lệ cho dữ liệu đầu vào.
AUDIENCE_TYPE_COMMERCE Loại đối tượng thương mại.

TargetingCriteria

Đã chỉ định tiêu chí nhắm mục tiêu.

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

object (SelectedTargetingOption)

Các lựa chọn đã chọn.

SelectedTargetingOption

(Các) lựa chọn nhắm mục tiêu đã chọn cho một loại tiêu chí nhắm mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "type": enum (TargetingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "audienceSelection": {
    object (AudienceSelection)
  },
  "targetingSelection": {
    object (TargetingSelection)
  }
  // End of mutually exclusive fields.
}
Trường
type

enum (TargetingType)

Loại tiêu chí nhắm mục tiêu liên kết với các lựa chọn đã chọn.
Bạn chỉ có thể chọn một loại. Lựa chọn được chọn phải tương ứng với TargetingType được chọn cho trường type. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
audienceSelection

object (AudienceSelection)

Đối tượng đã chọn.
targetingSelection

object (TargetingSelection)

Tập hợp chung gồm các mã lựa chọn đã chọn.
Kết thúc các trường loại trừ lẫn nhau.

TargetingType

Loại tiêu chí nhắm mục tiêu.

Enum
TARGETING_TYPE_UNSPECIFIED Loại tiêu chí nhắm mục tiêu không xác định, không hợp lệ cho dữ liệu đầu vào.
TARGETING_TYPE_AUDIENCE Đối tượng theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_COUNTRY Quốc gia thuộc loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_DMA Loại tiêu chí nhắm mục tiêu dma.
TARGETING_TYPE_PROGRAMMER Lập trình viên loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_BRAND Thương hiệu loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_CONTENT_GENRE Thể loại nội dung của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_DEVICE Thiết bị loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_OPERATING_SYSTEM Hệ điều hành loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_RATING Xếp hạng loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_ENVIRONMENT Môi trường loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_LANGUAGE Ngôn ngữ của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_GEO Loại tiêu chí nhắm mục tiêu theo vị trí địa lý.
TARGETING_TYPE_AGE Loại tiêu chí nhắm mục tiêu theo độ tuổi.
TARGETING_TYPE_GENDER Loại tiêu chí nhắm mục tiêu theo giới tính.
TARGETING_TYPE_CONTEXTUAL_SEGMENT Phân khúc theo ngữ cảnh của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_REQUEST_FORMAT Định dạng yêu cầu loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_PUBLISHER Nhà xuất bản loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_INVENTORY_SIZE Kích thước loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_NETWORK Mạng loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_PLATFORM Nền tảng loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_VIDEO_DELIVERY_TYPE Loại hình phân phối video theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE Kích thước trình phát tối thiểu của video theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_VIDEO_COMPLETION Loại tiêu chí nhắm mục tiêu vị trí đặt video.
TARGETING_TYPE_VIEWABILITY Khả năng xem theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_REWARDED Loại tiêu chí nhắm mục tiêu được thưởng.
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC Ngưỡng thời lượng quảng cáo dạng video theo loại tiêu chí nhắm mục tiêu (giây).
TARGETING_TYPE_VIDEO_PLACEMENT Loại tiêu chí nhắm mục tiêu vị trí đặt video.
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD Phương thức phát video theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_APP_ID Mã ứng dụng của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_DOMAIN_URL URL miền của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_CTR Tỷ lệ nhấp theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_DEMOGRAPHICS Thông tin nhân khẩu học của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_RESTRICTED_CATEGORY Danh mục bị hạn chế theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_AD_POSITION Vị trí quảng cáo theo loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_DAY_AND_TIME Ngày và giờ của loại tiêu chí nhắm mục tiêu.
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE Loại tiêu chí nhắm mục tiêu đối tượng truyền thông bán lẻ.

AudienceSelection

Các lựa chọn nhắm mục tiêu theo đối tượng đã chọn.

Biểu diễn dưới dạng JSON 
{
  "includedOrGroups": [
    {
      object (OrGroup)
    }
  ],
  "excludedOptionIds": [
    string
  ]
}
Trường
includedOrGroups[]

object (OrGroup)

Các lựa chọn được bao gồm sẽ kết hợp với nhau bằng toán tử AND, mỗi lựa chọn được bao gồm có thể là một lựa chọn riêng lẻ hoặc một nhóm lựa chọn kết hợp với nhau bằng toán tử OR.
excludedOptionIds[]

string (int64 format)

Các lựa chọn bị loại trừ được kết hợp với toán tử HOẶC.

OrGroup

Một nhóm các lựa chọn được chọn kết hợp với nhau bằng toán tử OR.

Biểu diễn dưới dạng JSON 
{
  "optionIds": [
    string
  ]
}
Trường
optionIds[]

string (int64 format)

Mã lựa chọn đã chọn.

TargetingSelection

Các tiêu chí nhắm mục tiêu đã chọn và bị loại trừ, áp dụng cho hầu hết các loại tiêu chí nhắm mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "optionIds": [
    string
  ],
  "externalIds": [
    string
  ],
  "excludedOptionIds": [
    string
  ],
  "excludedExternalIds": [
    string
  ]
}
Trường
optionIds[]

string (int64 format)

Chỉ có đầu ra. Mã tiêu chí nhắm mục tiêu DV3 đã chọn được chia sẻ với sàn giao dịch. Có thể được trả về cùng với excludedOptionIds miễn là hai danh sách không trùng lặp.
externalIds[]

string

Chỉ có đầu ra. Mã tiêu chí nhắm mục tiêu đã chọn do sàn giao dịch cung cấp. Có thể được trả về cùng với excludedExternalIds miễn là hai danh sách không trùng lặp.
excludedOptionIds[]

string (int64 format)

Chỉ có đầu ra. Mã tiêu chí nhắm mục tiêu DV3 bị loại trừ được chia sẻ với sàn giao dịch. Có thể được trả về cùng với optionIds miễn là hai danh sách không trùng lặp.
excludedExternalIds[]

string

Chỉ có đầu ra. Mã tiêu chí nhắm mục tiêu bị loại trừ do sàn giao dịch cung cấp. Có thể được trả về cùng với externalIds miễn là hai danh sách không trùng lặp.

ForecastResult

Kết quả dự báo được chỉ định.

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

object (Forecast)

Dự báo. forecastCategory phải là duy nhất cho mỗi phần tử được chỉ định.

Dự báo

Thông tin dự báo của danh mục dự báo được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "forecastCategory": enum (ForecastCategory),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "number": string,
  "percentage": integer,
  "cpmPrice": {
    object (Money)
  },
  "cpmRange": {
    object (CpmRange)
  },
  "forecastBreakdownData": {
    object (ForecastBreakdownData)
  }
  // End of mutually exclusive fields.
}
Trường
forecastCategory

enum (ForecastCategory)

Danh mục dự báo được chỉ định mà số liệu thống kê dự báo đại diện.
Bạn chỉ có thể thêm một loại dữ liệu thống kê. Dữ liệu được điền phải tương ứng với trường forecastCategory. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
number

string (int64 format)

Dữ liệu số.
percentage

integer

Dữ liệu tỷ lệ phần trăm.
cpmPrice

object (Money)

Dữ liệu giá CPM.
cpmRange

object (CpmRange)

Dữ liệu về khoảng giá CPM.
forecastBreakdownData

object (ForecastBreakdownData)

Dữ liệu chi tiết về thông tin dự báo.
Kết thúc các trường loại trừ lẫn nhau.

ForecastCategory

Danh mục dự báo.

Enum
FORECAST_CATEGORY_UNSPECIFIED Danh mục chưa xác định. Không hợp lệ cho dữ liệu đầu vào.
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES Tổng số cơ hội. Dữ liệu số.
FORECAST_CATEGORY_TOTAL_AUDIENCE Tổng số người xem. Dữ liệu số.
FORECAST_CATEGORY_DIGITAL_TRP Tỷ lệ tiếp cận mục tiêu kỹ thuật số. Dữ liệu tỷ lệ phần trăm.
FORECAST_CATEGORY_SUGGESTED_CPM Giá CPM đề xuất. Dữ liệu về phạm vi CPM hoặc giá CPM.
FORECAST_CATEGORY_UNIQUE_REACH Dự báo phạm vi tiếp cận riêng biệt. Dữ liệu số.
FORECAST_CATEGORY_FORECAST_BREAKDOWN Bảng chi tiết thông tin dự báo. Dữ liệu chi tiết về thông tin dự báo.

CpmRange

Phạm vi CPM chứa giá trị tối thiểu và tối đa của CPM.

Biểu diễn dưới dạng JSON 
{
  "minCpm": {
    object (Money)
  },
  "maxCpm": {
    object (Money)
  }
}
Trường
minCpm

object (Money)

Giới hạn dưới của phạm vi CPM.
maxCpm

object (Money)

Giới hạn trên của phạm vi CPM.

ForecastBreakdownData

Dữ liệu thông tin chi tiết về thông tin dự báo chứa danh sách thông tin chi tiết về thông tin dự báo.

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

object (ForecastBreakdown)

Danh sách thông tin chi tiết về thông tin dự báo.

ForecastBreakdown

Thông tin chi tiết về thông tin dự báo của tiêu chí nhắm mục tiêu đã chọn.

Biểu diễn dưới dạng JSON 
{
  "selectedTargetingOption": {
    object (SelectedTargetingOption)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressions": string
  // End of mutually exclusive fields.
}
Trường
selectedTargetingOption

object (SelectedTargetingOption)

(Các) lựa chọn nhắm mục tiêu đã chọn cho một loại tiêu chí nhắm mục tiêu.
Bạn chỉ có thể thêm một loại dữ liệu chi tiết. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
impressions

string (int64 format)

Dự báo số lượt hiển thị.
Kết thúc các trường loại trừ lẫn nhau.

ErrorDetails

Thông tin chi tiết về lỗi được chỉ định khi quá trình cập nhật có lỗi.

Biểu diễn dưới dạng JSON 
{
  "message": string,
  "instantDealErrorStatus": enum (InstantDealErrorStatus)
}
Trường
message

string

Thông báo được chỉ định khi cập nhật có lỗi.
instantDealErrorStatus

enum (InstantDealErrorStatus)

Trạng thái lỗi được chỉ định khi quá trình cập nhật có lỗi đối với giao dịch tức thì.

InstantDealErrorStatus

Trạng thái lỗi được chỉ định khi việc cập nhật giao dịch tức thì có lỗi.

Enum
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED Trạng thái lỗi không xác định.
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE Trạng thái lỗi cho biết không có khoảng không quảng cáo.
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE Trạng thái lỗi cho biết không có thông tin dự báo.
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT Trạng thái lỗi cho biết có các trường nhập dữ liệu không hợp lệ.

FrequencyCap

Số lần một người dùng có thể nhìn thấy cùng một quảng cáo trong một khoảng thời gian nhất định

Biểu diễn dưới dạng JSON 
{
  "timeUnit": enum (TimeUnit),
  "maxImpressions": string
}
Trường
timeUnit

enum (TimeUnit)

Đơn vị thời gian áp dụng giới hạn tần suất.
maxImpressions

string (int64 format)

Số lần tối đa mà một người dùng có thể nhìn thấy cùng một quảng cáo trong khoảng thời gian này.

TimeUnit

Đơn vị thời gian áp dụng giới hạn tần suất.

Enum
TIME_UNIT_UNSPECIFIED Đơn vị thời gian không xác định.
TIME_UNIT_LIFETIME Giới hạn tần suất sẽ được áp dụng cho toàn bộ thời gian hoạt động.
TIME_UNIT_MONTHS Giới hạn tần suất sẽ được áp dụng cho một số tháng.
TIME_UNIT_WEEKS Giới hạn tần suất sẽ được áp dụng cho một số tuần.
TIME_UNIT_DAYS Giới hạn tần suất sẽ được áp dụng cho một số ngày.

Phương thức

create

 Tạo sản phẩm.

get

 Lấy một sản phẩm.

list

 Liệt kê sản phẩm.

patch

 Cập nhật sản phẩm.