- ทรัพยากร: InventorySource
- 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 ทั้งหมด |
status |
การตั้งค่าสถานะของแหล่งที่มาของพื้นที่โฆษณา |
exchange |
การแลกเปลี่ยนที่เป็นแหล่งที่มาของพื้นที่โฆษณา |
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตแหล่งที่มาของสินค้าคงคลังครั้งล่าสุด กำหนดโดยระบบ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
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_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 |
ต้องระบุ ขอบเขตล่างของช่วงเวลา (รวมวันที่เริ่มต้น) การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
endTime |
ต้องระบุ ขอบเขตบนของช่วงเวลาแบบรวม การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
CreativeConfig
การกําหนดค่าข้อกําหนดของครีเอทีฟโฆษณาสําหรับแหล่งที่มาของพื้นที่โฆษณา
การแสดง JSON |
---|
{ "creativeType": enum ( |
ช่อง | |
---|---|
creativeType |
ประเภทครีเอทีฟโฆษณาที่กำหนดให้กับแหล่งที่มาของพื้นที่โฆษณาได้ รองรับเฉพาะประเภทต่อไปนี้
|
ฟิลด์สหภาพ
การกําหนดค่าสําหรับครีเอทีฟโฆษณาที่สามารถกําหนดให้กับแหล่งที่มาของพื้นที่โฆษณา |
|
displayCreativeConfig |
การกําหนดค่าสําหรับครีเอทีฟโฆษณา Display ใช้ได้เมื่อ |
videoCreativeConfig |
การกําหนดค่าสําหรับครีเอทีฟโฆษณาวิดีโอ ใช้ได้เมื่อ |
InventorySourceDisplayCreativeConfig
การกําหนดค่าสําหรับครีเอทีฟโฆษณา Display
การแสดง JSON |
---|
{
"creativeSize": {
object ( |
ช่อง | |
---|---|
creativeSize |
ข้อกําหนดด้านขนาดสําหรับครีเอทีฟโฆษณา Display ที่สามารถกําหนดให้กับแหล่งที่มาของพื้นที่โฆษณา |
InventorySourceVideoCreativeConfig
การกําหนดค่าสําหรับครีเอทีฟโฆษณาวิดีโอ
การแสดง JSON |
---|
{ "duration": string } |
ช่อง | |
---|---|
duration |
ข้อกําหนดด้านระยะเวลาของครีเอทีฟโฆษณาวิดีโอที่สามารถกําหนดให้กับแหล่งที่มาของพื้นที่โฆษณา ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
InventorySourceAccessors
พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ accessors พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา accessors ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
partner |
พาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา |
advertisers |
ผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา ผู้ลงโฆษณาทั้งหมดต้องมาจากพาร์ทเนอร์รายเดียวกัน |
PartnerAccessor
พาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา
การแสดง JSON |
---|
{ "partnerId": string } |
ช่อง | |
---|---|
partnerId |
รหัสของพาร์ทเนอร์ |
AdvertiserAccessors
ผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณา
การแสดง JSON |
---|
{ "advertiserIds": [ string ] } |
ช่อง | |
---|---|
advertiserIds[] |
รหัสของผู้ลงโฆษณา |
เมธอด |
|
---|---|
|
สร้างแหล่งที่มาของพื้นที่โฆษณาใหม่ |
|
แก้ไขตัวเข้าถึงแบบอ่าน/เขียนของแหล่งที่มาของพื้นที่โฆษณา |
|
รับแหล่งที่มาของพื้นที่โฆษณา |
|
แสดงแหล่งที่มาของพื้นที่โฆษณาที่ผู้ใช้ปัจจุบันเข้าถึงได้ |
|
อัปเดตแหล่งที่มาของสินค้าคงคลังที่มีอยู่ |