REST Resource: exchanges.orders.products

แหล่งข้อมูล: ผลิตภัณฑ์

ผลิตภัณฑ์

การแสดง 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
}
ช่อง
name

string

ชื่อทรัพยากรแบบสัมพัทธ์สำหรับผลิตภัณฑ์ สร้างโดยเซิร์ฟเวอร์ ตัวอย่าง: "exchanges/1234/orders/5678/products/abc" เอาต์พุตเท่านั้น
displayName

string

ชื่อที่แสดงของผลิตภัณฑ์

ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ไบต์ ต้องระบุ
externalDealId

string

รหัสภายนอก นี่คือรหัสดีลในระบบ Exchange สูงสุด 100 อักขระ อักขระที่อนุญาตคือตัวอักษรและตัวเลขคละกัน ขีดล่าง ขีดกลาง และจุด ต้องไม่ซ้ำกันในผลิตภัณฑ์ทั้งหมด ต้องระบุ
transactionType

enum (TransactionType)

ประเภทธุรกรรมของผลิตภัณฑ์ ต้องระบุ
pricingType

enum (PricingType)

ประเภทการกำหนดราคาสำหรับผลิตภัณฑ์ ต้องระบุ
updateTime
(deprecated)

string (Timestamp format)

การประทับเวลาที่อัปเดตผลิตภัณฑ์ครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
startTime

string (Timestamp format)

เวลาที่ผลิตภัณฑ์นี้เริ่มทำงาน ต้องอยู่ก่อน endTime เวลาเริ่มต้นต้องไม่เกิน 1 ปีนับจากนี้ ต้องระบุ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

เวลาที่ผลิตภัณฑ์นี้จะไม่มีการใช้งาน ต้องไม่เกินปี 2579 ต้องระบุ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
rateDetails

object (RateDetails)

รายละเอียดราคา ต้องระบุ
creativeConfig[]

object (CreativeConfig)

ข้อกำหนดด้านครีเอทีฟโฆษณาสำหรับผลิตภัณฑ์ ต้องระบุสำหรับผลิตภัณฑ์ประเภทธุรกรรมที่จองไว้
makegood
(deprecated)

boolean

ระบุว่าผลิตภัณฑ์เป็นผลิตภัณฑ์ชดเชยหรือไม่
makegoodDetails
(deprecated)

object (MakegoodDetails)

รายละเอียดค่าชดเชยสำหรับผลิตภัณฑ์ ต้องระบุเมื่อผลิตภัณฑ์เป็น Makegood
creativeSource

enum (CreativeSource)

แหล่งที่มาของครีเอทีฟโฆษณาสำหรับผลิตภัณฑ์ ไม่บังคับ ค่าเริ่มต้นคือ CREATIVE_SOURCE_ADVERTISER เปลี่ยนไม่ได้หลังจากสร้างผลิตภัณฑ์แล้ว
mediumType

enum (MediumType)

ประเภทสื่อสำหรับผลิตภัณฑ์ ค่าเริ่มต้นจะเป็น DIGITAL หากไม่ได้ระบุไว้เพื่อความเข้ากันได้แบบย้อนหลัง เปลี่ยนไม่ได้หลังจากสร้างผลิตภัณฑ์แล้ว
audienceTargetingConfig

object (AudienceTargetingConfig)

ไม่บังคับ การกำหนดค่าการกำหนดกลุ่มเป้าหมายที่ใช้ในระดับดีลใน Exchange
targetingCriteria

object (TargetingCriteria)

เอาต์พุตเท่านั้น ข้อมูลอ้างอิงเกณฑ์การกำหนดเป้าหมายผลิตภัณฑ์ ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น
forecastResult

object (ForecastResult)

ผลการคาดการณ์ผลิตภัณฑ์ ต้องระบุเมื่อเกณฑ์การกำหนดเป้าหมายไม่ว่างเปล่าและไม่มีการคาดการณ์ ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น
errorDetails

object (ErrorDetails)

ต้องระบุรายละเอียดข้อผิดพลาดเมื่ออัปเดตช่องสินค้าที่เฉพาะเจาะจงไม่ได้ ต้องระบุเมื่อไม่สามารถแสดงผลการคาดการณ์ได้เนื่องจากเกณฑ์การกำหนดเป้าหมาย หรือไม่สามารถอัปเดตผลิตภัณฑ์ได้ ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น
frequencyCap

object (FrequencyCap)

เอาต์พุตเท่านั้น ความถี่สูงสุดที่ผู้ซื้อเลือก ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น
program

string

เอาต์พุตเท่านั้น โปรแกรมที่ผู้ซื้อใช้สร้างดีลแบบทันที เว้นว่างไว้สำหรับขั้นตอนการแลกเปลี่ยนปกติ ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น
buyerCustomParameters

map (key: string, value: string)

เอาต์พุตเท่านั้น พารามิเตอร์คีย์/ค่าที่กำหนดเองซึ่งผู้ซื้อตั้งค่าไว้ในคำขอดีลแบบทันที ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
etag

string

ETag ที่ต้องระบุเมื่ออัปเดตผลิตภัณฑ์ คุณต้องระบุสำหรับการอัปเดตก็ต่อเมื่อช่อง etag ไม่ว่างเปล่า ใช้ได้กับสถานการณ์ดีลแบบทันทีเท่านั้น

CreativeConfig

การกำหนดค่าข้อกำหนดสำหรับครีเอทีฟโฆษณาของผลิตภัณฑ์

การแสดง JSON 
{
  "creativeType": enum (CreativeType),
  "dimensionCreativeConfig": {
    object (DimensionCreativeConfig)
  },
  "durationCreativeConfig": {
    object (DurationCreativeConfig)
  }
}
ช่อง
creativeType

enum (CreativeType)

ประเภทครีเอทีฟโฆษณา ต้องระบุ
dimensionCreativeConfig

object (DimensionCreativeConfig)

การกำหนดค่าสำหรับครีเอทีฟโฆษณา Display ระบบไม่รองรับช่องนี้สำหรับครีเอทีฟโฆษณาเนทีฟ (CREATIVE_TYPE_NATIVE)
durationCreativeConfig

object (DurationCreativeConfig)

การกำหนดค่าสำหรับครีเอทีฟโฆษณาวิดีโอ

CreativeType

ประเภทครีเอทีฟโฆษณาที่เป็นไปได้

Enum
CREATIVE_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทครีเอทีฟโฆษณา ค่าที่ป้อนไม่ถูกต้อง
CREATIVE_TYPE_DISPLAY ประเภทครีเอทีฟโฆษณาของ Display
CREATIVE_TYPE_VIDEO ประเภทครีเอทีฟโฆษณาของวิดีโอ
CREATIVE_TYPE_AUDIO ประเภทครีเอทีฟโฆษณาเสียง
CREATIVE_TYPE_NATIVE ประเภทครีเอทีฟโฆษณาเนทีฟ ระบบไม่รองรับการดำเนินการนี้สำหรับผลิตภัณฑ์ประเภทธุรกรรม RESERVED

DimensionCreativeConfig

ขนาดครีเอทีฟโฆษณา Display เป็นพิกเซล

การแสดง JSON 
{
  "width": integer,
  "height": integer
}
ช่อง
width

integer

ความกว้างของครีเอทีฟโฆษณา Display ต้องระบุ
height

integer

ความสูงของครีเอทีฟโฆษณา Display ต้องระบุ

DurationCreativeConfig

การกำหนดค่าสำหรับครีเอทีฟโฆษณาในระยะเวลา

การแสดง JSON 
{
  "duration": string,
  "durationMatchType": enum (DurationMatchType),
  "skippableMatchType": enum (SkippableMatchType)
}
ช่อง
duration

string (Duration format)

ระยะเวลาของครีเอทีฟโฆษณาวิดีโอเป็นวินาที ต้องระบุ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมสูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"
durationMatchType

enum (DurationMatchType)

เกณฑ์การจับคู่ระยะเวลา
skippableMatchType

enum (SkippableMatchType)

ประเภทแบบข้ามได้ของครีเอทีฟโฆษณาวิดีโอ

DurationMatchType

เกณฑ์การจับคู่สำหรับระยะเวลาของครีเอทีฟโฆษณาวิดีโอ

Enum
DURATION_MATCH_TYPE_UNSPECIFIED ไม่ได้ระบุเกณฑ์การจับคู่ระยะเวลาหรือไม่รู้จักเกณฑ์ดังกล่าวในเวอร์ชันนี้ ค่าที่ป้อนไม่ถูกต้อง
DURATION_MATCH_TYPE_EQUAL_TO ระยะเวลาของครีเอทีฟโฆษณาต้องเท่ากับระยะเวลาที่กำหนด
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO ระยะเวลาของครีเอทีฟโฆษณาต้องเท่ากับหรือน้อยกว่าระยะเวลาที่กำหนด

SkippableMatchType

เกณฑ์การจับคู่ว่าครีเอทีฟโฆษณาวิดีโอข้ามได้หรือไม่

Enum
SKIPPABLE_MATCH_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทที่ข้ามได้หรือไม่รู้จักในเวอร์ชันนี้ ค่าที่ป้อนไม่ถูกต้อง
SKIPPABLE_MATCH_TYPE_SKIPPABLE ครีเอทีฟโฆษณาต้องข้ามได้
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE ครีเอทีฟโฆษณาต้องข้ามไม่ได้
SKIPPABLE_MATCH_TYPE_ANY โดยครีเอทีฟโฆษณาอาจเป็นแบบข้ามได้หรือข้ามไม่ได้

MakegoodDetails

การกำหนดค่าสำหรับรายละเอียดค่าชดเชย

การแสดง JSON 
{
  "originalExternalDealId": string,
  "reason": string
}
ช่อง
originalExternalDealId

string

รหัสดีลภายนอกเดิมที่ขอการชดเชย สูงสุด 100 อักขระ อักขระที่อนุญาตคือตัวอักษรและตัวเลขคละกัน ขีดล่าง ขีดกลาง และจุด ต้องระบุ
reason

string

เหตุผลในการชดเชยที่ผู้ขายเป็นผู้เริ่ม สูงสุด 250 อักขระ ต้องระบุ

CreativeSource

แหล่งที่มาของครีเอทีฟโฆษณา ซึ่งเป็นตำแหน่งที่จะแสดงครีเอทีฟโฆษณา

Enum
CREATIVE_SOURCE_UNSPECIFIED ไม่ได้ระบุแหล่งที่มาของครีเอทีฟโฆษณาหรือไม่รู้จักในเวอร์ชันนี้ ค่าที่ป้อนไม่ถูกต้อง
CREATIVE_SOURCE_ADVERTISER ครีเอทีฟโฆษณาจะแสดงโดย DV3
CREATIVE_SOURCE_PUBLISHER ผู้เผยแพร่โฆษณาจะแสดงครีเอทีฟโฆษณา ปัจจุบันระบบยังไม่รองรับครีเอทีฟโฆษณาที่โฮสต์โดยผู้เผยแพร่โฆษณา คำขอใดๆ ที่พยายามตั้งค่าแหล่งที่มาของครีเอทีฟโฆษณาเป็น CREATIVE_SOURCE_PUBLISHER จะไม่สำเร็จ

AudienceTargetingConfig

การกำหนดค่าสำหรับการกำหนดกลุ่มเป้าหมาย

การแสดง JSON 
{
  "audienceType": enum (AudienceType)
}
ช่อง
audienceType

enum (AudienceType)

ประเภทกลุ่มเป้าหมาย ต้องระบุ

AudienceType

ประเภทกลุ่มเป้าหมาย

Enum
AUDIENCE_TYPE_UNSPECIFIED ประเภทกลุ่มเป้าหมายที่ไม่ระบุ ไม่ถูกต้องสำหรับอินพุต
AUDIENCE_TYPE_COMMERCE ประเภทกลุ่มเป้าหมาย Commerce

TargetingCriteria

ระบุเกณฑ์การกำหนดเป้าหมายแล้ว

การแสดง JSON 
{
  "selectedTargetingOptions": [
    {
      object (SelectedTargetingOption)
    }
  ]
}
ช่อง
selectedTargetingOptions[]

object (SelectedTargetingOption)

ตัวเลือกที่เลือก

SelectedTargetingOption

ตัวเลือกการกำหนดเป้าหมายที่เลือกหรือตัวเลือกสำหรับประเภทการกำหนดเป้าหมายเดียว

การแสดง 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.
}
ช่อง
type

enum (TargetingType)

ประเภทการกำหนดเป้าหมายที่เชื่อมโยงกับตัวเลือกที่เลือก
รวมการเลือกได้เพียงประเภทเดียวเท่านั้น ตัวเลือกที่เลือกต้องสอดคล้องกับ TargetingType ที่เลือกสำหรับช่อง type ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
audienceSelection

object (AudienceSelection)

กลุ่มเป้าหมายที่เลือก
targetingSelection

object (TargetingSelection)

ชุดรหัสตัวเลือกที่เลือกแบบทั่วไป
สิ้นสุดฟิลด์ที่แยกกัน

TargetingType

ประเภทการกำหนดเป้าหมาย

Enum
TARGETING_TYPE_UNSPECIFIED ประเภทการกำหนดเป้าหมายที่ไม่ได้ระบุ ไม่ถูกต้องสำหรับอินพุต
TARGETING_TYPE_AUDIENCE กลุ่มเป้าหมายประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_COUNTRY ประเทศประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_DMA ประเภทการกำหนดเป้าหมาย dma
TARGETING_TYPE_PROGRAMMER โปรแกรมเมอร์ประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_BRAND แบรนด์ประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_CONTENT_GENRE ประเภทการกำหนดเป้าหมายตามประเภทเนื้อหา
TARGETING_TYPE_DEVICE อุปกรณ์ประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_OPERATING_SYSTEM ระบบปฏิบัติการประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_RATING การจัดประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_ENVIRONMENT สภาพแวดล้อมประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_LANGUAGE ภาษาของประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_GEO ภูมิศาสตร์ประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_AGE อายุประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_GENDER เพศประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_CONTEXTUAL_SEGMENT กลุ่มตามบริบทประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_REQUEST_FORMAT รูปแบบคำขอประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_PUBLISHER ผู้เผยแพร่โฆษณาประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_INVENTORY_SIZE ขนาดประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_NETWORK เครือข่ายประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_PLATFORM แพลตฟอร์มประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_VIDEO_DELIVERY_TYPE ประเภทการแสดงโฆษณาวิดีโอประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE ขนาดเพลเยอร์ขั้นต่ำของวิดีโอประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_VIDEO_COMPLETION ตำแหน่งวิดีโอประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_VIEWABILITY การมองเห็นโฆษณาตามประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_REWARDED ประเภทการกำหนดเป้าหมายที่มีการให้รางวัล
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC เกณฑ์ระยะเวลาของโฆษณาวิดีโอประเภทการกำหนดเป้าหมาย (วินาที)
TARGETING_TYPE_VIDEO_PLACEMENT ตำแหน่งวิดีโอประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD วิธีการเล่นวิดีโอประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_APP_ID รหัสแอปประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_DOMAIN_URL URL โดเมนประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_CTR อัตราการคลิกผ่านของประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_DEMOGRAPHICS ข้อมูลประชากรประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_RESTRICTED_CATEGORY หมวดหมู่ที่จำกัดประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_AD_POSITION อันดับโฆษณาประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_DAY_AND_TIME วันและเวลาของประเภทการกำหนดเป้าหมาย
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE ประเภทการกำหนดเป้าหมายกลุ่มเป้าหมายของสื่อการค้าปลีก

AudienceSelection

ตัวเลือกการกำหนดกลุ่มเป้าหมายที่เลือก

การแสดง JSON 
{
  "includedOrGroups": [
    {
      object (OrGroup)
    }
  ],
  "excludedOptionIds": [
    string
  ]
}
ช่อง
includedOrGroups[]

object (OrGroup)

ตัวเลือกที่รวมไว้จะเชื่อมต่อด้วย AND โดยตัวเลือกที่รวมไว้แต่ละรายการอาจเป็นตัวเลือกเดี่ยวๆ หรือกลุ่มตัวเลือกที่เชื่อมต่อด้วย OR ก็ได้
excludedOptionIds[]

string (int64 format)

ตัวเลือกที่ยกเว้นจะเชื่อมต่อด้วย OR

OrGroup

กลุ่มตัวเลือกที่เลือกซึ่งเชื่อมต่อด้วย OR

การแสดง JSON 
{
  "optionIds": [
    string
  ]
}
ช่อง
optionIds[]

string (int64 format)

รหัสตัวเลือกที่เลือก

TargetingSelection

ตัวเลือกการกำหนดเป้าหมายที่เลือกและยกเว้น ซึ่งใช้ได้กับประเภทการกำหนดเป้าหมายส่วนใหญ่

การแสดง JSON 
{
  "optionIds": [
    string
  ],
  "externalIds": [
    string
  ],
  "excludedOptionIds": [
    string
  ],
  "excludedExternalIds": [
    string
  ]
}
ช่อง
optionIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสตัวเลือกการกำหนดเป้าหมาย DV3 ที่เลือกซึ่งแชร์กับ Exchange อาจแสดงผลควบคู่ไปกับ excludedOptionIds ตราบใดที่ทั้ง 2 รายการไม่ทับซ้อนกัน
externalIds[]

string

เอาต์พุตเท่านั้น รหัสตัวเลือกการกำหนดเป้าหมายที่เลือกซึ่ง Exchange ระบุไว้ อาจแสดงผลพร้อมกับ excludedExternalIds ตราบใดที่ทั้ง 2 รายการไม่ทับซ้อนกัน
excludedOptionIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสตัวเลือกการกำหนดเป้าหมาย DV3 ที่ยกเว้นซึ่งแชร์กับ Exchange อาจแสดงผลควบคู่ไปกับ optionIds ตราบใดที่ทั้ง 2 รายการไม่ทับซ้อนกัน
excludedExternalIds[]

string

เอาต์พุตเท่านั้น รหัสตัวเลือกการกำหนดเป้าหมายที่ยกเว้นซึ่งระบุโดย Exchange อาจแสดงผลควบคู่ไปกับ externalIds ตราบใดที่ทั้ง 2 รายการไม่ทับซ้อนกัน

ForecastResult

ระบุผลการคาดการณ์แล้ว

การแสดง JSON 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
ช่อง
forecasts[]

object (Forecast)

การคาดการณ์ forecastCategory ต้องไม่ซ้ำกันสำหรับแต่ละองค์ประกอบที่ระบุ

การคาดการณ์

การคาดการณ์ของหมวดหมู่การคาดการณ์ที่ระบุ

การแสดง 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.
}
ช่อง
forecastCategory

enum (ForecastCategory)

หมวดหมู่การคาดการณ์ที่ระบุซึ่งสถิติการคาดการณ์แสดงถึง
รวมข้อมูลสถิติได้เพียงประเภทเดียวเท่านั้น ข้อมูลที่ป้อนต้องสอดคล้องกับช่อง forecastCategory ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
number

string (int64 format)

ข้อมูลตัวเลข
percentage

integer

ข้อมูลเปอร์เซ็นต์
cpmPrice

object (Money)

ข้อมูลราคา CPM
cpmRange

object (CpmRange)

ข้อมูลช่วงราคา CPM
forecastBreakdownData

object (ForecastBreakdownData)

ข้อมูลรายละเอียดการคาดการณ์
สิ้นสุดฟิลด์ที่แยกกัน

ForecastCategory

หมวดหมู่การคาดการณ์

Enum
FORECAST_CATEGORY_UNSPECIFIED หมวดหมู่ที่ไม่ได้ระบุ ไม่ถูกต้องสำหรับอินพุต
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES โอกาสทั้งหมด ข้อมูลตัวเลข
FORECAST_CATEGORY_TOTAL_AUDIENCE ผู้ชมทั้งหมด ข้อมูลตัวเลข
FORECAST_CATEGORY_DIGITAL_TRP คะแนนเรตติ้งเป้าหมายแบบดิจิทัล ข้อมูลเปอร์เซ็นต์
FORECAST_CATEGORY_SUGGESTED_CPM ราคา CPM ที่แนะนำ ช่วง CPM หรือข้อมูลราคา CPM
FORECAST_CATEGORY_UNIQUE_REACH คาดการณ์ Unique Reach ข้อมูลตัวเลข
FORECAST_CATEGORY_FORECAST_BREAKDOWN รายละเอียดการคาดการณ์ ข้อมูลรายละเอียดการคาดการณ์

CpmRange

ช่วง CPM ประกอบด้วย CPM ต่ำสุดและสูงสุด

การแสดง JSON 
{
  "minCpm": {
    object (Money)
  },
  "maxCpm": {
    object (Money)
  }
}
ช่อง
minCpm

object (Money)

ขอบเขตล่างของช่วง CPM
maxCpm

object (Money)

ขอบเขตบนของช่วง CPM

ForecastBreakdownData

ข้อมูลรายละเอียดการคาดการณ์มีรายการรายละเอียดการคาดการณ์

การแสดง JSON 
{
  "forecastBreakdowns": [
    {
      object (ForecastBreakdown)
    }
  ]
}
ช่อง
forecastBreakdowns[]

object (ForecastBreakdown)

รายการรายละเอียดการคาดการณ์

ForecastBreakdown

รายละเอียดการคาดการณ์ของตัวเลือกการกำหนดเป้าหมายที่เลือก

การแสดง 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.
}
ช่อง
selectedTargetingOption

object (SelectedTargetingOption)

ตัวเลือกการกำหนดเป้าหมายที่เลือกหรือตัวเลือกสำหรับประเภทการกำหนดเป้าหมายเดียว
รวมข้อมูลรายละเอียดได้เพียงประเภทเดียวเท่านั้น ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
impressions

string (int64 format)

การแสดงผลที่คาดการณ์ไว้
สิ้นสุดฟิลด์ที่แยกกัน

ErrorDetails

รายละเอียดข้อผิดพลาดที่ระบุเมื่อการอัปเดตมีข้อผิดพลาด

การแสดง JSON 
{
  "message": string,
  "instantDealErrorStatus": enum (InstantDealErrorStatus)
}
ช่อง
message

string

ข้อความที่ระบุเมื่อการอัปเดตมีข้อผิดพลาด
instantDealErrorStatus

enum (InstantDealErrorStatus)

สถานะข้อผิดพลาดที่ระบุเมื่อการอัปเดตมีข้อผิดพลาดสำหรับดีลแบบทันที

InstantDealErrorStatus

สถานะข้อผิดพลาดที่ระบุเมื่อการอัปเดตดีลทันทีมีข้อผิดพลาด

Enum
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED สถานะข้อผิดพลาดที่ไม่ได้ระบุ
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE สถานะข้อผิดพลาดระบุว่าสินค้าคงคลังไม่พร้อมใช้งาน
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE สถานะข้อผิดพลาดบ่งบอกว่าไม่มีการคาดการณ์
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT สถานะข้อผิดพลาดระบุว่ามีช่องป้อนข้อมูลที่ไม่ถูกต้อง

FrequencyCap

จำนวนครั้งที่ผู้ใช้อาจเห็นโฆษณาเดียวกันในช่วงระยะเวลาหนึ่งๆ

การแสดง JSON 
{
  "timeUnit": enum (TimeUnit),
  "maxImpressions": string
}
ช่อง
timeUnit

enum (TimeUnit)

หน่วยเวลาที่จะใช้การกำหนดความถี่สูงสุด
maxImpressions

string (int64 format)

จำนวนครั้งสูงสุดที่ผู้ใช้อาจเห็นโฆษณาเดียวกันในช่วงเวลานี้

TimeUnit

หน่วยเวลาที่จะใช้ความถี่สูงสุด

Enum
TIME_UNIT_UNSPECIFIED หน่วยเวลาที่ไม่ได้ระบุ
TIME_UNIT_LIFETIME ระบบจะใช้ความถี่สูงสุดตลอดอายุการใช้งาน
TIME_UNIT_MONTHS ความถี่สูงสุดจะใช้กับจำนวนเดือน
TIME_UNIT_WEEKS ระบบจะใช้ความถี่สูงสุดกับจำนวนสัปดาห์
TIME_UNIT_DAYS ระบบจะใช้ความถี่สูงสุดกับจำนวนวัน

เมธอด

create

 สร้างผลิตภัณฑ์

get

 รับผลิตภัณฑ์

list

 แสดงรายการผลิตภัณฑ์

patch

 อัปเดตผลิตภัณฑ์