REST Resource: partners.inventorySources

Tài nguyên: InventorySource

Một nguồn khoảng không quảng cáo.

Biểu diễn dưới dạng 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
  ]
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của nguồn khoảng không quảng cáo.

inventorySourceId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của nguồn khoảng không quảng cáo. Do hệ thống chỉ định.

displayName

string

Tên hiển thị của nguồn kho hàng.

Phải được mã hoá theo UTF-8 với kích thước tối đa là 240 byte.

inventorySourceType

enum (InventorySourceType)

Biểu thị loại nguồn khoảng không quảng cáo.

inventorySourceProductType

enum (InventorySourceProductType)

Chỉ có đầu ra. Loại sản phẩm của nguồn khoảng không quảng cáo, cho biết cách bán khoảng không quảng cáo.

commitment

enum (InventorySourceCommitment)

Liệu nguồn khoảng không quảng cáo có được đảm bảo phân phối hay không được đảm bảo phân phối.

deliveryMethod

enum (InventorySourceDeliveryMethod)

Phương thức phân phối của nguồn khoảng không quảng cáo.

  • Đối với các nguồn khoảng không quảng cáo không được đảm bảo, giá trị duy nhất được chấp nhận là INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Đối với nguồn khoảng không quảng cáo được đảm bảo, các giá trị được chấp nhận là INVENTORY_SOURCE_DELIVERY_METHOD_TAG và INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

Mã nhận dạng trong không gian trao đổi giúp xác định duy nhất nguồn khoảng không quảng cáo.

Phải là duy nhất cho mỗi người mua trong mỗi sàn giao dịch nhưng không nhất thiết phải là duy nhất cho các sàn giao dịch.

status

object (InventorySourceStatus)

Chế độ cài đặt trạng thái của nguồn khoảng không quảng cáo.

exchange

enum (Exchange)

Sàn giao dịch mà nguồn khoảng không quảng cáo thuộc về.

updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi nguồn dữ liệu kho hàng được cập nhật lần gần đây nhất. Do hệ thống chỉ định.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

rateDetails

object (RateDetails)

Bắt buộc. Thông tin chi tiết về giá của nguồn khoảng không quảng cáo.

publisherName

string

Tên nhà xuất bản/người bán của nguồn khoảng không quảng cáo.

timeRange

object (TimeRange)

Phạm vi thời gian khi nguồn khoảng không quảng cáo này bắt đầu và ngừng phân phát.

creativeConfigs[]

object (CreativeConfig)

Yêu cầu về mẫu quảng cáo của nguồn khoảng không quảng cáo.

Không áp dụng cho gói đấu giá.

guaranteedOrderId

string

Không thể thay đổi. Mã của đơn đặt hàng được đảm bảo mà nguồn khoảng không quảng cáo này thuộc về.

Chỉ áp dụng khi commitment là INVENTORY_SOURCE_COMMITMENT_GUARANTEED.

readWriteAccessors

object (InventorySourceAccessors)

Đối tác hoặc nhà quảng cáo có quyền đọc/ghi đối với nguồn khoảng không quảng cáo.

Chỉ xuất khi commitment là INVENTORY_SOURCE_COMMITMENT_GUARANTEED, trong trường hợp đó, các trình truy cập đọc/ghi được kế thừa từ đơn vị quảng cáo được đảm bảo gốc.

Bắt buộc khi commitment là INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Nếu commitment là INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED và một đối tác được đặt trong trường này, thì tất cả nhà quảng cáo thuộc đối tác này sẽ tự động có quyền chỉ có thể đọc đối với nguồn khoảng không quảng cáo. Những nhà quảng cáo này sẽ không được đưa vào readAdvertiserIds.

readAdvertiserIds[]

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của những nhà quảng cáo có quyền chỉ đọc đối với nguồn khoảng không quảng cáo.

readPartnerIds[]

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của những đối tác có quyền chỉ có thể đọc đối với nguồn khoảng không quảng cáo.

Tất cả nhà quảng cáo của đối tác trong trường này đều kế thừa quyền chỉ có thể đọc đối với nguồn khoảng không quảng cáo.

Phương thức

get

Lấy một thoả thuận về nguồn khoảng không quảng cáo.

list

Liệt kê các giao dịch của nguồn khoảng không quảng cáo.