REST Resource: partners.inventorySources

ทรัพยากร: InventorySource

แหล่งที่มาของพื้นที่โฆษณา

การแสดง JSON 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของแหล่งที่มาของพื้นที่โฆษณา
inventorySourceId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของแหล่งที่มาของพื้นที่โฆษณา กำหนดโดยระบบ
displayName

string

ชื่อที่แสดงของแหล่งที่มาของพื้นที่โฆษณา

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

enum (InventorySourceType)

ระบุประเภทของแหล่งที่มาของพื้นที่โฆษณา
inventorySourceProductType

enum (InventorySourceProductType)

เอาต์พุตเท่านั้น ประเภทสินค้าของแหล่งที่มาพื้นที่โฆษณา ซึ่งแสดงถึงวิธีขายพื้นที่โฆษณา
commitment

enum (InventorySourceCommitment)

แหล่งที่มาของพื้นที่โฆษณามีการแสดงโฆษณาที่รับประกันการแสดงผลหรือไม่รับประกันการแสดงผล
deliveryMethod

enum (InventorySourceDeliveryMethod)

วิธีการแสดงโฆษณาของแหล่งที่มาของพื้นที่โฆษณา

  • สำหรับแหล่งที่มาของพื้นที่โฆษณาที่ไม่รับประกันการแสดงผล ค่าเดียวที่ยอมรับได้คือ INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC
  • สำหรับแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผล ค่าที่ยอมรับได้คือ INVENTORY_SOURCE_DELIVERY_METHOD_TAG และ INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC
dealId

string

รหัสในพื้นที่ Exchange ที่ระบุแหล่งที่มาของพื้นที่โฆษณาโดยไม่ซ้ำกัน

ต้องไม่ซ้ำกันสำหรับผู้ซื้อภายใน Exchange แต่ละรายการ แต่ไม่จำเป็นต้องไม่ซ้ำกันใน Exchange ต่างๆ
status

object (InventorySourceStatus)

การตั้งค่าสถานะของแหล่งที่มาของพื้นที่โฆษณา
exchange

enum (Exchange)

Exchange ที่เป็นเจ้าของแหล่งที่มาของพื้นที่โฆษณา
updateTime

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"
rateDetails

object (RateDetails)

ต้องระบุ รายละเอียดอัตราของแหล่งที่มาของพื้นที่โฆษณา
publisherName

string

ชื่อผู้เผยแพร่โฆษณา/ผู้ขายของแหล่งที่มาของพื้นที่โฆษณา
timeRange

object (TimeRange)

ช่วงเวลาที่แหล่งที่มาของพื้นที่โฆษณานี้เริ่มและหยุดแสดง
creativeConfigs[]

object (CreativeConfig)

ข้อกำหนดด้านครีเอทีฟโฆษณาของแหล่งที่มาของพื้นที่โฆษณา

ไม่เกี่ยวข้องกับแพ็กเกจการประมูล
guaranteedOrderId

string

เปลี่ยนแปลงไม่ได้ รหัสของรายการโฆษณาที่รับประกันการแสดงผลซึ่งเป็นเจ้าของแหล่งที่มาของพื้นที่โฆษณานี้

ใช้ได้เฉพาะเมื่อ commitment เป็น INVENTORY_SOURCE_COMMITMENT_GUARANTEED
readWriteAccessors

object (InventorySourceAccessors)

พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์อ่าน/เขียนในแหล่งที่มาของพื้นที่โฆษณา

เอาต์พุตเฉพาะเมื่อ commitment เป็น INVENTORY_SOURCE_COMMITMENT_GUARANTEED ซึ่งในกรณีนี้ ตัวช่วยเข้าถึงการอ่าน/เขียนจะรับค่ามาจากรายการโฆษณาที่รับประกันแบบเป็นโปรแกรมระดับบนสุด

ต้องระบุเมื่อ commitment เป็น INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED

หาก commitment เป็น INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED และมีการตั้งค่าพาร์ทเนอร์ในช่องนี้ ผู้ลงโฆษณาทั้งหมดภายใต้พาร์ทเนอร์รายนี้จะมีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณาแบบอ่านอย่างเดียวโดยอัตโนมัติ ผู้ลงโฆษณาเหล่านี้จะไม่รวมอยู่ใน readAdvertiserIds
readAdvertiserIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสของผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงระดับอ่านอย่างเดียวในแหล่งที่มาของพื้นที่โฆษณา
readPartnerIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสของพาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณาแบบอ่านอย่างเดียว

ผู้ลงโฆษณาทั้งหมดของพาร์ทเนอร์ในช่องนี้จะรับช่วงสิทธิ์การเข้าถึงระดับอ่านอย่างเดียวในแหล่งที่มาของพื้นที่โฆษณา

เมธอด

get

 รับดีลแหล่งที่มาของพื้นที่โฆษณา

list

 แสดงรายการดีลแหล่งที่มาของพื้นที่โฆษณา