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