- Tài nguyên: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails (Chi tiết về giá)
- InventorySourceRateType
- Tiền
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- Phương thức
Tài nguyên: InventorySource
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 ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của nguồn khoảng không quảng cáo. |
inventorySourceId |
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 |
Tên hiển thị của nguồn khoảng không quảng cáo. Phải là mã UTF-8 với kích thước tối đa là 240 byte. |
inventorySourceType |
Biểu thị loại nguồn khoảng không quảng cáo. |
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 thức bán khoảng không quảng cáo. |
commitment |
Liệu nguồn khoảng không quảng cáo có phân phối được đảm bảo hay không được đảm bảo. |
deliveryMethod |
Phương thức phân phối của nguồn khoảng không quảng cáo.
|
dealId |
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 giữa 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 giữa các sàn giao dịch. |
status |
Chế độ cài đặt trạng thái của nguồn khoảng không quảng cáo. |
exchange |
Trao đổi mà nguồn khoảng không quảng cáo thuộc về. |
updateTime |
Chỉ có đầu ra. Dấu thời gian khi nguồn khoảng không quảng cáo được cập nhật lần gần đây nhất. Do hệ thống chỉ định. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
rateDetails |
Bắt buộc. Chi tiết giá của nguồn khoảng không quảng cáo. |
publisherName |
Tên nhà xuất bản/người bán của nguồn khoảng không quảng cáo. |
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[] |
Các 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 các gói đấu giá. |
guaranteedOrderId |
Không thể thay đổi. Mã đơn đặt hàng được đảm bảo chứa nguồn khoảng không quảng cáo này. Chỉ áp dụng khi |
readWriteAccessors |
Đố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 Bắt buộc khi Nếu |
readAdvertiserIds[] |
Chỉ có đầu ra. Mã nhận dạng của các nhà quảng cáo có quyền chỉ có thể đọc đối với nguồn khoảng không quảng cáo. |
readPartnerIds[] |
Chỉ có đầu ra. Mã nhận dạng của các đố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ả cá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 vào nguồn khoảng không quảng cáo. |
InventorySourceType
Các loại nguồn khoảng không quảng cáo có thể có.
Enum | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
Loại nguồn khoảng không quảng cáo không được chỉ định hoặc không xác định trong phiên bản này. |
INVENTORY_SOURCE_TYPE_PRIVATE |
Nguồn khoảng không quảng cáo riêng tư. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
Gói đấu giá. |
InventorySourceProductType
Các loại sản phẩm có thể có của một nguồn kho hàng.
Enum | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
Loại sản phẩm không được chỉ định hoặc không xác định trong phiên bản này. Việc sửa đổi nguồn dữ liệu kho hàng của loại sản phẩm này không được hỗ trợ thông qua API. |
PREFERRED_DEAL |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua Giao dịch ưu tiên. |
PRIVATE_AUCTION |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua Phiên đấu giá kín. |
PROGRAMMATIC_GUARANTEED |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua giao dịch Đảm bảo có lập trình. |
TAG_GUARANTEED |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua giao dịch Đảm bảo bằng thẻ. |
YOUTUBE_RESERVE |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua Dành riêng trên YouTube. |
INSTANT_RESERVE |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua tính năng Đặt trước nhanh. Việc sửa đổi nguồn dữ liệu kho hàng của loại sản phẩm này không được hỗ trợ thông qua API. |
GUARANTEED_PACKAGE |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua Gói được bảo đảm. Việc sửa đổi nguồn dữ liệu kho hàng của loại sản phẩm này không được hỗ trợ thông qua API. |
PROGRAMMATIC_TV |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua Programmtic TV. Việc sửa đổi nguồn dữ liệu kho hàng của loại sản phẩm này không được hỗ trợ thông qua API. |
AUCTION_PACKAGE |
Nguồn khoảng không quảng cáo bán khoảng không quảng cáo thông qua Gói đấu giá. Việc sửa đổi nguồn dữ liệu kho hàng của loại sản phẩm này không được hỗ trợ thông qua API. |
InventorySourceCommitment
Các loại cam kết có thể có cho một nguồn khoảng không quảng cáo.
Enum | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
Cam kết không được chỉ định hoặc không xác định trong phiên bản này. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
Cam kết phân phối được đảm bảo. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
Cam kết là phân phối không được đảm bảo. |
InventorySourceDeliveryMethod
Các phương thức phân phối có thể có cho một nguồn khoảng không quảng cáo.
Enum | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
Cách phân phối chưa được chỉ định hoặc không xác định trong phiên bản này. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
Cách phân phối là có lập trình. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
Cách phân phối là gắn thẻ. |
InventorySourceStatus
Chế độ cài đặt liên quan đến trạng thái của nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "entityStatus": enum ( |
Các trường | |
---|---|
entityStatus |
Liệu nguồn khoảng không quảng cáo có thể phân phát hay không. Các giá trị được chấp nhận là |
entityPauseReason |
Lý do do người dùng đưa ra để tạm dừng nguồn khoảng không quảng cáo này. Không được vượt quá 100 ký tự. Chỉ áp dụng khi bạn đặt |
sellerStatus |
Chỉ có đầu ra. Trạng thái do người bán đặt cho nguồn khoảng không quảng cáo. Chỉ áp dụng cho nguồn khoảng không quảng cáo được đồng bộ hoá trực tiếp từ nhà xuất bản. Giá trị được chấp nhận là |
sellerPauseReason |
Chỉ có đầu ra. Người bán đã đưa ra lý do để tạm dừng nguồn khoảng không quảng cáo này. Chỉ áp dụng cho nguồn khoảng không quảng cáo được đồng bộ hoá trực tiếp từ nhà xuất bản và khi bạn đặt |
configStatus |
Chỉ có đầu ra. Trạng thái cấu hình của nguồn khoảng không quảng cáo. Chỉ áp dụng cho nguồn khoảng không quảng cáo được đảm bảo. Giá trị được chấp nhận là Bạn phải thiết lập nguồn khoảng không quảng cáo (điền vào các trường bắt buộc, chọn mẫu quảng cáo và chọn chiến dịch mặc định) để nguồn khoảng không quảng cáo có thể phân phát. |
InventorySourceConfigStatus
Các trạng thái cấu hình có thể có cho nguồn khoảng không quảng cáo được đảm bảo.
Enum | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
Trạng thái phê duyệt không được chỉ định hoặc không xác định trong phiên bản này. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
Trạng thái bắt đầu của nguồn khoảng không quảng cáo được đảm bảo. Nguồn khoảng không quảng cáo ở trạng thái này cần được định cấu hình. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
Trạng thái sau khi người mua định cấu hình nguồn khoảng không quảng cáo được đảm bảo. |
RateDetails
Chế độ cài đặt liên quan đến giá của nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "inventorySourceRateType": enum ( |
Các trường | |
---|---|
inventorySourceRateType |
Loại giá. Các giá trị được chấp nhận là |
rate |
Giá cho nguồn khoảng không quảng cáo. |
unitsPurchased |
Bắt buộc đối với nguồn khoảng không quảng cáo được đảm bảo. Số lượt hiển thị được người bán đảm bảo. |
minimumSpend |
Chỉ có đầu ra. Số tiền mà người mua đã cam kết chi tiêu trước cho nguồn khoảng không quảng cáo. Chỉ áp dụng cho nguồn khoảng không quảng cáo được đảm bảo. |
InventorySourceRateType
Các loại giá có thể có cho một nguồn khoảng không quảng cáo.
Enum | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
Loại giá chưa được chỉ định hoặc không xác định trong phiên bản này. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
Loại giá là CPM (Cố định). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
Loại giá là CPM (Giá sàn). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
Loại giá là Chi phí mỗi ngày. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
Loại mức giá là Cố định. |
Tiền
Biểu thị số tiền cùng với loại đơn vị tiền tệ.
Biểu diễn dưới dạng JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Các trường | |
---|---|
currencyCode |
Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217. |
units |
Toàn bộ đơn vị của số tiền. Ví dụ: nếu |
nanos |
Số lượng nano (10^-9) đơn vị của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu |
TimeRange
Một khoảng thời gian.
Biểu diễn dưới dạng JSON |
---|
{ "startTime": string, "endTime": string } |
Các trường | |
---|---|
startTime |
Bắt buộc. Giới hạn dưới của một phạm vi thời gian, tính cả 2 giá trị đầu cuối. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
endTime |
Bắt buộc. Giới hạn trên của một phạm vi thời gian, tính cả 2 giá trị đầu cuối. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
CreativeConfig
Cấu hình các yêu cầu về mẫu quảng cáo cho nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "creativeType": enum ( |
Các trường | |
---|---|
creativeType |
Loại mẫu quảng cáo có thể được chỉ định cho nguồn khoảng không quảng cáo. Chúng tôi chỉ hỗ trợ các loại sau:
|
Trường nhóm
Cấu hình của các mẫu quảng cáo có thể được chỉ định cho nguồn khoảng không quảng cáo. |
|
displayCreativeConfig |
Cấu hình cho mẫu quảng cáo hiển thị. Áp dụng khi |
videoCreativeConfig |
Cấu hình của mẫu quảng cáo dạng video. Áp dụng khi |
InventorySourceDisplayCreativeConfig
Cấu hình cho mẫu quảng cáo hiển thị.
Biểu diễn dưới dạng JSON |
---|
{
"creativeSize": {
object ( |
Các trường | |
---|---|
creativeSize |
Yêu cầu về kích thước đối với mẫu quảng cáo hiển thị có thể được chỉ định cho nguồn khoảng không quảng cáo. |
InventorySourceVideoCreativeConfig
Cấu hình của mẫu quảng cáo dạng video.
Biểu diễn dưới dạng JSON |
---|
{ "duration": string } |
Các trường | |
---|---|
duration |
Yêu cầu về thời lượng cho mẫu quảng cáo dạng video có thể được chỉ định cho nguồn khoảng không quảng cáo. Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng ' |
InventorySourceAccessors
Đối tác hoặc các nhà quảng cáo có quyền truy cập vào nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm accessors . Đối tác hoặc các nhà quảng cáo có quyền truy cập vào nguồn khoảng không quảng cáo. accessors chỉ có thể là một trong những trạng thái sau đây: |
|
partner |
Đối tác có quyền truy cập vào nguồn khoảng không quảng cáo. |
advertisers |
Các nhà quảng cáo có quyền truy cập vào nguồn khoảng không quảng cáo. Tất cả nhà quảng cáo phải thuộc cùng một đối tác. |
PartnerAccessor
Đối tác có quyền truy cập vào nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "partnerId": string } |
Các trường | |
---|---|
partnerId |
Mã của đối tác. |
AdvertiserAccessors
Các nhà quảng cáo có quyền truy cập vào nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "advertiserIds": [ string ] } |
Các trường | |
---|---|
advertiserIds[] |
Mã nhận dạng của nhà quảng cáo. |
Phương thức |
|
---|---|
|
Tạo nguồn khoảng không quảng cáo mới. |
|
Chỉnh sửa trình truy cập đọc/ghi của nguồn khoảng không quảng cáo. |
|
Nhận nguồn khoảng không quảng cáo. |
|
Liệt kê các nguồn khoảng không quảng cáo mà người dùng hiện tại có thể truy cập. |
|
Cập nhật nguồn khoảng không quảng cáo hiện có. |