REST Resource: exchanges.inventorySources

Tài nguyên: InventorySource

Mô hình thực thi của một nguồn khoảng không quảng cáo trên 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 đơn đặt hàng. 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 định giá cho sản phẩm.
rateDetails

object (RateDetails)

Chỉ có đầu ra. Thông tin chi tiết về giá.
startTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian 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 cách thời điểm hiện tại quá 1 năm.

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".
endTime

string (Timestamp format)

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

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".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Thông tin dự báo số lượng hằng ngày do sàn giao dịch cung cấp. Được 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 giao dịch đảm bảo có lập trình có tính năng nhắm mục tiêu theo đối tượng, được sà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 từ 0 đến 1, bạn nên dùng số nghịch đảo của số này làm hệ số nhân 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 đến đối tượng. Ví dụ: "0.125". Điều này cho biết 12, 5% yêu cầu khớp với tiêu chí nhắm đến đố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 người mua yêu cầu Quảng cáo đền bù.
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 giao dịch đảm bảo 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ừ và 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 và do đó, không có giới hạn tần suất nào được áp dụng. 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ẽ loại trừ 20% lưu lượng truy cập khỏi giới hạn tần suất.
dv360WseatId[]

string (int64 format)

Chỉ có đầu ra. Các wseat hiện được cấp 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 đây nhất.

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".
creativeApprovalConfig

object (CreativeApprovalConfig)

Không bắt buộc. Cấu hình để phê duyệt mẫu quảng cáo. Bạn có thể phải được 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 Bạn chưa chỉ định trạng thái của người mua. Giá trị đầu vào 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 đang chờ xử lý. Trạng thái này có nghĩa là giao dịch 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à do người mua tạm dừng.

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. Ngoài dự kiến, trạng thái này cho biết trạng thái thương lượng là không xác định. Giá trị đầu vào không hợp lệ.
SELLER_STATUS_ACTIVE Trạng thái người bán đang hoạt động. Nguồn khoảng không quảng cáo đang hoạt động ở phía sàn giao dịch.
SELLER_STATUS_PAUSED Trạng thái người bán là tạm dừng.

InventorySourceVolumeForecast

Dự báo số lượng yêu cầu 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ẽ được áp dụng: – bạn phải cung cấp một mục nhập cho mỗi ngày trong tuần – khối lượng phải là số không âm – bạn phải có timeZoneId và timeZoneId 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 số lượng hằng ngày.
timeZoneId

string

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

DailyVolume

Số lượng yêu cầu cho một nguồn khoảng không quảng cáo trong 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 mà số lượng yêu cầu áp dụng.
volume

string (int64 format)

Số lượng yêu cầu dự kiến cho ngày trong tuần đã cho.

DayOfWeek

Biểu thị 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 để 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ó cần được phê duyệt trước khi được 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 publisher_config được đặt, thì mẫu quảng cáo cần được phê duyệt trước khi được sử dụng ở 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 một 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 một nguồn kho hàng.