REST Resource: exchanges.inventorySources

Tài nguyên: InventorySource

Mô hình thực thi của nguồn khoảng không quảng cáo DV360.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên tương đối cho thứ tự. Do máy chủ tạo. Ví dụ: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Chỉ có đầu ra. Trạng thái của người mua.
sellerStatus

enum (SellerStatus)

Trạng thái của người bán.
transactionType

enum (TransactionType)

Chỉ có đầu ra. Loại giao dịch sản phẩm.
pricingType

enum (PricingType)

Chỉ có đầu ra. Loại giá của sản phẩm.
rateDetails

object (RateDetails)

Chỉ có đầu ra. Chi tiết về giá.
startTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm sản phẩm này bắt đầu hoạt động. Phải sớm hơn endTime. Thời gian bắt đầu không được quá 1 năm nữa.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời 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".
endTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm sản phẩm này không hoạt động.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời 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".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Sàn giao dịch đã cung cấp thông tin dự đoán về khối lượng giao dịch hằng ngày. Dùng để xác định tốc độ và cho phép người mua lựa chọn. Trường này không được dùng nữa.
audienceMatchRate

number

Chỉ có đầu ra. Tỷ lệ khớp đối tượng dự đoán cho các giao dịch đảm bảo có lập trình có tiêu chí nhắm mục tiêu theo đối tượng. Tỷ lệ này được bên giao dịch sử dụng để xác định số lượng yêu cầu bổ sung cần gửi. Đây là một số thập phân nằm trong khoảng từ 0 đến 1, giá trị nghịch đảo của số này sẽ được dùng làm hệ số cho số lượt hiển thị. 0 cho biết trường này chưa được đặt và do đó không có tiêu chí nhắm mục tiêu theo đối tượng. Ví dụ: "0,125". Điều này cho biết 12, 5% số yêu cầu khớp với tiêu chí nhắm mục tiêu theo đối tượng và số lượng yêu cầu được gửi phải gấp 8 lần số lượt hiển thị đã thương lượng.
makegoodRequested

boolean

Chỉ có đầu ra. Cho biết liệu người mua có yêu cầu Quảng cáo đền bù hay không.
makegoodRequestedReason

string

Chỉ có đầu ra. Lý do yêu cầu quảng cáo đền bù do người mua cung cấp.
percentFrequencyCapExcludedTraffic

string (int64 format)

Tỷ lệ phần trăm lưu lượng truy cập bị loại trừ khỏi giới hạn tần suất cho một thoả thuận bảo đảm có lập trình. Đây là một số nguyên từ 0 đến 100. Giá trị 0 (cũng là giá trị mặc định) cho biết không có tiêu chí loại trừ nào, do đó, tất cả lưu lượng truy cập đều đủ điều kiện áp dụng giới hạn tần suất. Giá trị 100 cho biết tiêu chí loại trừ hoàn toàn, do đó, hệ thống sẽ không áp dụng giới hạn tần suất. Giá trị từ 0 đến 100 sẽ dẫn đến việc loại trừ một phần. Ví dụ: giá trị 20 sẽ dẫn đến việc 20% lưu lượng truy cập bị loại trừ khỏi giới hạn tần suất.
dv360WseatId[]

string (int64 format)

Chỉ có đầu ra. Các wseat hiện có quyền truy cập vào nguồn khoảng không quảng cáo.
lastModifiedTime

string (Timestamp format)

Chỉ có đầu ra. Lần gần đây nhất nguồn dữ liệu kho hàng được cập nhật. Xin lưu ý rằng một số bản cập nhật nội bộ của DV3 sẽ thay đổi thời gian sửa đổi gần nhất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời 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".
creativeApprovalConfig

object (CreativeApprovalConfig)

Không bắt buộc. Cấu hình cho quy trình Phê duyệt mẫu quảng cáo. Có thể cần phải phê duyệt ở cấp sàn giao dịch hoặc ở cấp nhà xuất bản.

BuyerStatus

Trạng thái của người mua.

Enum
BUYER_STATUS_UNSPECIFIED Chưa chỉ định trạng thái của người mua. Giá trị nhập không hợp lệ.
BUYER_STATUS_ACTIVE Trạng thái của người mua là đang hoạt động. Mục hàng được chỉ định, mẫu quảng cáo hợp lệ được chỉ định.
BUYER_STATUS_PENDING Trạng thái của người mua là đang chờ xử lý. Trạng thái này có nghĩa là thoả thuận không hoạt động và người mua cần thực hiện một số hành động nhất định.
BUYER_STATUS_PAUSED Trạng thái của người mua là tạm dừng bởi người mua.

SellerStatus

Trạng thái của người bán.

Enum
SELLER_STATUS_UNSPECIFIED Chưa xác định trạng thái người bán. Không mong muốn, cho biết trạng thái thương lượng là không xác định. Giá trị nhập không hợp lệ.
SELLER_STATUS_ACTIVE Trạng thái của người bán là đang hoạt động. Nguồn khoảng không quảng cáo đang hoạt động ở phía trao đổi.
SELLER_STATUS_PAUSED Trạng thái của người bán là tạm dừng.

InventorySourceVolumeForecast

Số lượng yêu cầu dự báo hằng ngày cho một nguồn khoảng không quảng cáo. Các quy tắc xác thực sau đây sẽ áp dụng: – phải cung cấp một mục cho mỗi ngày trong tuần – âm lượng phải là số dương – timeZoneId là bắt buộc và phải hợp lệ

Biểu diễn dưới dạng JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Trường
dailyVolumes[]

object (DailyVolume)

Dự báo về khối lượng hằng ngày.
timeZoneId

string

Múi giờ của Cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_York", được dùng cho số lượt xem hằng ngày.

DailyVolume

Yêu cầu số lượng cho một nguồn khoảng không quảng cáo vào một ngày cụ thể.

Biểu diễn dưới dạng JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Trường
day

enum (DayOfWeek)

Ngày trong tuần áp dụng cho số lượng yêu cầu.
volume

string (int64 format)

Số lượng yêu cầu dự kiến cho một ngày trong tuần nhất định.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY Friday (thứ Sáu)
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

CreativeApprovalConfig

Cấu hình cho quy trình Phê duyệt mẫu quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Trường
requiresExchangeApproval

boolean

Bắt buộc. Cho biết liệu mẫu quảng cáo có yêu cầu phê duyệt trước khi nhập ở cấp trao đổi hay không.
publisherConfigs[]

object (PublisherConfig)

Không bắt buộc. Cấu hình cho nhà xuất bản.

PublisherConfig

Cấu hình cho nhà xuất bản (publisher_config). Nếu bạn đặt publisher_config, thì mẫu quảng cáo phải được phê duyệt trước khi nhập ở cấp nhà xuất bản.

Biểu diễn dưới dạng JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Trường
publisherId

string

Bắt buộc. Mã nhà xuất bản.
publisherDisplayName

string

Bắt buộc. Tên nhà xuất bản.

Phương thức

get

 Lấy nguồn khoảng không quảng cáo.

list

 Liệt kê các nguồn khoảng không quảng cáo.

patch

 Cập nhật nguồn khoảng không quảng cáo.