- ทรัพยากร: InventorySource
- การแสดง JSON
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- เงิน
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- เมธอด
ทรัพยากร: InventorySource
แหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
| ช่อง | |
|---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของแหล่งที่มาของพื้นที่โฆษณา |
inventorySourceId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของแหล่งที่มาของพื้นที่โฆษณา กำหนดโดยระบบ |
displayName |
ชื่อที่แสดงของแหล่งที่มาของพื้นที่โฆษณา ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ไบต์ |
inventorySourceType |
ระบุประเภทของแหล่งที่มาของพื้นที่โฆษณา |
inventorySourceProductType |
เอาต์พุตเท่านั้น ประเภทสินค้าของแหล่งที่มาพื้นที่โฆษณา ซึ่งแสดงถึงวิธีขายพื้นที่โฆษณา |
commitment |
แหล่งที่มาของพื้นที่โฆษณามีการแสดงโฆษณาที่รับประกันการแสดงผลหรือไม่รับประกันการแสดงผล |
deliveryMethod |
วิธีการแสดงโฆษณาของแหล่งที่มาของพื้นที่โฆษณา
|
dealId |
รหัสในพื้นที่ Exchange ที่ระบุแหล่งที่มาของพื้นที่โฆษณาโดยไม่ซ้ำกัน ต้องไม่ซ้ำกันสำหรับผู้ซื้อภายใน Exchange แต่ละรายการ แต่ไม่จำเป็นต้องไม่ซ้ำกันใน Exchange ต่างๆ |
status |
การตั้งค่าสถานะของแหล่งที่มาของพื้นที่โฆษณา |
exchange |
Exchange ที่เป็นเจ้าของแหล่งที่มาของพื้นที่โฆษณา |
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตแหล่งที่มาของพื้นที่โฆษณาครั้งล่าสุด กำหนดโดยระบบ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
rateDetails |
ต้องระบุ รายละเอียดอัตราของแหล่งที่มาของพื้นที่โฆษณา |
publisherName |
ชื่อผู้เผยแพร่โฆษณา/ผู้ขายของแหล่งที่มาของพื้นที่โฆษณา |
timeRange |
ช่วงเวลาที่แหล่งที่มาของพื้นที่โฆษณานี้เริ่มและหยุดแสดง |
creativeConfigs[] |
ข้อกำหนดด้านครีเอทีฟโฆษณาของแหล่งที่มาของพื้นที่โฆษณา ไม่เกี่ยวข้องกับแพ็กเกจการประมูล |
guaranteedOrderId |
เปลี่ยนแปลงไม่ได้ รหัสของรายการโฆษณาที่รับประกันการแสดงผลซึ่งเป็นเจ้าของแหล่งที่มาของพื้นที่โฆษณานี้ ใช้ได้เฉพาะเมื่อ |
readWriteAccessors |
พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์อ่าน/เขียนในแหล่งที่มาของพื้นที่โฆษณา เอาต์พุตเฉพาะเมื่อ ต้องระบุเมื่อ หาก |
readAdvertiserIds[] |
เอาต์พุตเท่านั้น รหัสของผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงระดับอ่านอย่างเดียวในแหล่งที่มาของพื้นที่โฆษณา |
readPartnerIds[] |
เอาต์พุตเท่านั้น รหัสของพาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณาแบบอ่านอย่างเดียว ผู้ลงโฆษณาทั้งหมดของพาร์ทเนอร์ในช่องนี้จะรับช่วงสิทธิ์การเข้าถึงระดับอ่านอย่างเดียวในแหล่งที่มาของพื้นที่โฆษณา |
InventorySourceType
ประเภทแหล่งที่มาของพื้นที่โฆษณาที่เป็นไปได้
| Enum | |
|---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทแหล่งที่มาของพื้นที่โฆษณาหรือไม่ทราบประเภทในเวอร์ชันนี้ |
INVENTORY_SOURCE_TYPE_PRIVATE |
แหล่งที่มาของพื้นที่โฆษณาส่วนตัว |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
แพ็กเกจการประมูล |
InventorySourceProductType
ประเภทสินค้าที่เป็นไปได้ของแหล่งที่มาของพื้นที่โฆษณา
| Enum | |
|---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทสินค้าหรือไม่รู้จักในเวอร์ชันนี้ API ไม่รองรับการแก้ไขแหล่งที่มาของสินค้าคงคลังของประเภทสินค้านี้ |
PREFERRED_DEAL |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านดีลที่ต้องการ |
PRIVATE_AUCTION |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านการประมูลส่วนตัว |
PROGRAMMATIC_GUARANTEED |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านการรับประกันแบบเป็นโปรแกรม |
TAG_GUARANTEED |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านการรับประกันแท็ก |
YOUTUBE_RESERVE |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่าน YouTube Reserve |
INSTANT_RESERVE |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านจองทันที API ไม่รองรับการแก้ไขแหล่งที่มาของสินค้าคงคลังของประเภทสินค้านี้ |
GUARANTEED_PACKAGE |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านแพ็กเกจที่รับประกันการแสดงผล API ไม่รองรับการแก้ไขแหล่งที่มาของพื้นที่โฆษณาของผลิตภัณฑ์ประเภทนี้ |
PROGRAMMATIC_TV |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านทีวีแบบเป็นโปรแกรม API ไม่รองรับการแก้ไขแหล่งที่มาของสินค้าคงคลังของประเภทสินค้านี้ |
AUCTION_PACKAGE |
แหล่งที่มาของพื้นที่โฆษณาขายพื้นที่โฆษณาผ่านแพ็กเกจการประมูล API ไม่รองรับการแก้ไขแหล่งที่มาของสินค้าคงคลังของประเภทผลิตภัณฑ์นี้ |
InventorySourceCommitment
ประเภทสัญญาผูกมัดที่เป็นไปได้สำหรับแหล่งที่มาของพื้นที่โฆษณา
| Enum | |
|---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
ไม่ได้ระบุสัญญาผูกมัดหรือไม่ทราบสัญญาผูกมัดในเวอร์ชันนี้ |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
ข้อผูกมัดคือการรับประกันการแสดงผล |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
ข้อผูกมัดคือการแสดงผลที่ไม่รับประกันการแสดงผล |
InventorySourceDeliveryMethod
วิธีการแสดงโฆษณาที่เป็นไปได้สำหรับแหล่งที่มาของพื้นที่โฆษณา
| Enum | |
|---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
ไม่ได้ระบุวิธีการนำส่งหรือไม่ทราบวิธีการนำส่งในเวอร์ชันนี้ |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
วิธีการแสดงโฆษณาเป็นแบบเป็นโปรแกรม |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
วิธีการนำส่งคือแท็ก |
InventorySourceStatus
การตั้งค่าที่เกี่ยวข้องกับสถานะของแหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ "entityStatus": enum ( |
| ช่อง | |
|---|---|
entityStatus |
แหล่งที่มาของพื้นที่โฆษณาแสดงได้หรือไม่ ค่าที่ยอมรับคือ |
entityPauseReason |
เหตุผลที่ผู้ใช้ระบุสำหรับการหยุดแหล่งที่มาของพื้นที่โฆษณานี้ชั่วคราว ต้องมีความยาวไม่เกิน 100 อักขระ ใช้ได้เฉพาะเมื่อตั้งค่า |
sellerStatus |
เอาต์พุตเท่านั้น สถานะที่ผู้ขายตั้งค่าไว้สำหรับแหล่งที่มาของพื้นที่โฆษณา ใช้ได้กับแหล่งที่มาของพื้นที่โฆษณาที่ซิงค์จากผู้เผยแพร่โฆษณาโดยตรงเท่านั้น ค่าที่ยอมรับคือ |
sellerPauseReason |
เอาต์พุตเท่านั้น เหตุผลที่ผู้ขายระบุสำหรับการหยุดใช้แหล่งที่มาของพื้นที่โฆษณานี้ชั่วคราว ใช้ได้กับแหล่งที่มาของพื้นที่โฆษณาที่ซิงค์โดยตรงจากผู้เผยแพร่โฆษณาและเมื่อตั้งค่า |
configStatus |
เอาต์พุตเท่านั้น สถานะการกำหนดค่าของแหล่งที่มาของพื้นที่โฆษณา ใช้ได้กับแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผลเท่านั้น ค่าที่ยอมรับคือ ต้องกำหนดค่าแหล่งที่มาของพื้นที่โฆษณา (กรอกข้อมูลในช่องที่ต้องกรอก เลือกครีเอทีฟโฆษณา และเลือกแคมเปญเริ่มต้น) ก่อนจึงจะแสดงได้ |
InventorySourceConfigStatus
สถานะการกำหนดค่าที่เป็นไปได้สำหรับแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผล
| Enum | |
|---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
ไม่ได้ระบุสถานะการอนุมัติหรือไม่ทราบสถานะการอนุมัติในเวอร์ชันนี้ |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
สถานะเริ่มต้นของแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผล ต้องกำหนดค่าแหล่งที่มาของพื้นที่โฆษณาในสถานะนี้ |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
สถานะหลังจากที่ผู้ซื้อกำหนดค่าแหล่งที่มาของพื้นที่โฆษณาที่รับประกัน |
RateDetails
การตั้งค่าที่เกี่ยวข้องกับอัตราของแหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ "inventorySourceRateType": enum ( |
| ช่อง | |
|---|---|
inventorySourceRateType |
ประเภทราคา ค่าที่ยอมรับคือ |
rate |
อัตราสำหรับแหล่งที่มาของพื้นที่โฆษณา |
unitsPurchased |
ต้องระบุสำหรับแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผล จำนวนการแสดงผลที่ผู้ขายรับประกัน |
minimumSpend |
เอาต์พุตเท่านั้น จำนวนเงินที่ผู้ซื้อตกลงที่จะใช้จ่ายกับแหล่งที่มาของพื้นที่โฆษณาล่วงหน้า ใช้ได้กับแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผลเท่านั้น |
InventorySourceRateType
ประเภทอัตราที่เป็นไปได้สำหรับแหล่งที่มาของพื้นที่โฆษณา
| Enum | |
|---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทอัตราหรือไม่รู้จักในเวอร์ชันนี้ |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
ประเภทอัตราคือ CPM (คงที่) |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
ประเภทอัตราคือ CPM (พื้น) |
INVENTORY_SOURCE_RATE_TYPE_CPD |
ประเภทอัตราคือต้นทุนต่อวัน |
INVENTORY_SOURCE_RATE_TYPE_CPH |
ประเภทอัตราคือต้นทุนต่อชั่วโมง |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
ประเภทอัตราคือแบบคงที่ |
เงินทอง
แสดงจำนวนเงินพร้อมประเภทสกุลเงิน
| การแสดง JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| ช่อง | |
|---|---|
currencyCode |
รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217 |
units |
หน่วยทั้งหมดของจำนวนเงิน เช่น หาก |
nanos |
จำนวนหน่วยนาโน (10^-9) ของจำนวนเงิน ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 (รวม) หาก |
TimeRange
ช่วงเวลา
| การแสดง JSON |
|---|
{ "startTime": string, "endTime": string } |
| ช่อง | |
|---|---|
startTime |
ต้องระบุ ขอบเขตล่างของช่วงเวลา (รวมค่านี้) ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
endTime |
ต้องระบุ ขอบเขตบนของช่วงเวลา (รวม) ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
CreativeConfig
การกำหนดค่าข้อกำหนดครีเอทีฟโฆษณาสำหรับแหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ "creativeType": enum ( |
| ช่อง | |
|---|---|
creativeType |
ประเภทของครีเอทีฟโฆษณาที่กำหนดให้กับแหล่งที่มาของพื้นที่โฆษณาได้ รองรับเฉพาะประเภทต่อไปนี้เท่านั้น
|
ใช้ได้เมื่อ
การกำหนดค่าสำหรับครีเอทีฟโฆษณาที่สามารถกำหนดให้กับแหล่งที่มาของพื้นที่โฆษณา ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ |
|
displayCreativeConfig |
การกำหนดค่าสำหรับครีเอทีฟโฆษณา Display ใช้ได้เมื่อ |
videoCreativeConfig |
การกำหนดค่าสำหรับครีเอทีฟโฆษณาวิดีโอ ใช้ได้เมื่อ |
| สิ้นสุดฟิลด์ที่แยกกัน | |
InventorySourceDisplayCreativeConfig
การกำหนดค่าสำหรับครีเอทีฟโฆษณา Display
| การแสดง JSON |
|---|
{
"creativeSize": {
object ( |
| ช่อง | |
|---|---|
creativeSize |
ข้อกำหนดด้านขนาดสำหรับครีเอทีฟโฆษณา Display ที่สามารถกำหนดให้กับแหล่งที่มาของพื้นที่โฆษณา |
InventorySourceVideoCreativeConfig
การกำหนดค่าสำหรับครีเอทีฟโฆษณาวิดีโอ
| การแสดง JSON |
|---|
{ "duration": string } |
| ช่อง | |
|---|---|
duration |
ข้อกำหนดด้านระยะเวลาสำหรับครีเอทีฟโฆษณาวิดีโอที่กำหนดให้กับแหล่งที่มาของพื้นที่โฆษณาได้ ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมสูงสุด 9 หลัก โดยลงท้ายด้วย " |
InventorySourceAccessors
พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "partner": { object ( |
| ช่อง | |
|---|---|
| พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
partner |
พาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา |
advertisers |
ผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา ผู้ลงโฆษณาทั้งหมดต้องเป็นของพาร์ทเนอร์รายเดียวกัน |
| สิ้นสุดฟิลด์ที่แยกกัน | |
PartnerAccessor
พาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ "partnerId": string } |
| ช่อง | |
|---|---|
partnerId |
รหัสของพาร์ทเนอร์ |
AdvertiserAccessors
ผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา
| การแสดง JSON |
|---|
{ "advertiserIds": [ string ] } |
| ช่อง | |
|---|---|
advertiserIds[] |
รหัสของผู้ลงโฆษณา |
เมธอด |
|
|---|---|
|
รับดีลแหล่งที่มาของพื้นที่โฆษณา |
|
แสดงรายการดีลแหล่งที่มาของพื้นที่โฆษณา |