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)
  },
  "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)

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

ใช้ 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)

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

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)

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

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 ประเภทครีเอทีฟโฆษณาแบบดิสเพลย์
CREATIVE_TYPE_VIDEO ประเภทครีเอทีฟโฆษณาวิดีโอ
CREATIVE_TYPE_AUDIO ประเภทครีเอทีฟโฆษณาเสียง
CREATIVE_TYPE_NATIVE ประเภทครีเอทีฟโฆษณาเนทีฟ

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 ประเภทกลุ่มเป้าหมายการค้า

TargetingCriteria

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

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

object (SelectedTargetingOption)

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

SelectedTargetingOption

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

การแสดง JSON
{
  "type": enum (TargetingType),

  // Union field value can be only one of the following:
  "audienceSelection": {
    object (AudienceSelection)
  },
  "targetingSelection": {
    object (TargetingSelection)
  }
  // End of list of possible types for union field value.
}
ช่อง
type

enum (TargetingType)

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

ฟิลด์ Union value โดยจะรวมได้เพียงการเลือกประเภทเดียวเท่านั้น การเลือกที่เลือกต้องสอดคล้องกับ TargetingType ที่เลือกสำหรับช่อง "type" value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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 ขนาดขั้นต่ำของเพลเยอร์วิดีโอประเภทการกำหนดเป้าหมาย

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

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

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

string (int64 format)

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

ForecastResult

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

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

object (Forecast)

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

การคาดการณ์

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

การแสดง JSON
{
  "forecastCategory": enum (ForecastCategory),

  // Union field forecast_data can be only one of the following:
  "number": string,
  "percentage": integer,
  "cpmPrice": {
    object (Money)
  },
  "cpmRange": {
    object (CpmRange)
  },
  "forecastBreakdownData": {
    object (ForecastBreakdownData)
  }
  // End of list of possible types for union field forecast_data.
}
ช่อง
forecastCategory

enum (ForecastCategory)

หมวดหมู่การคาดการณ์ที่ระบุซึ่งสถิติการคาดการณ์แสดง

ฟิลด์ Union forecast_data รวมได้เฉพาะข้อมูลสถิติประเภทเดียวเท่านั้น ข้อมูลที่ป้อนต้องสอดคล้องกับช่อง "forecastCategory" forecast_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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)
  },

  // Union field breakdown_data can be only one of the following:
  "impressions": string
  // End of list of possible types for union field breakdown_data.
}
ช่อง
selectedTargetingOption

object (SelectedTargetingOption)

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

ฟิลด์ Union breakdown_data รวมได้เฉพาะข้อมูลการแบ่งประเภท 1 ประเภทเท่านั้น breakdown_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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

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