REST Resource: inventorySources

Resource: InventorySource

Sumber inventaris.

Representasi 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)
    }
  ],
  "subSitePropertyId": string,
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
Kolom
name

string

Hanya output. Nama resource sumber inventaris.
inventorySourceId

string (int64 format)

Hanya output. ID unik sumber inventaris. Ditetapkan oleh sistem.
displayName

string

Nama tampilan sumber inventaris.

Harus dienkode UTF-8 dengan ukuran maksimum 240 byte.
inventorySourceType

enum (InventorySourceType)

Menunjukkan jenis sumber inventaris.
inventorySourceProductType

enum (InventorySourceProductType)

Hanya output. Jenis produk dari sumber inventaris, menunjukkan cara penjualan inventaris.
commitment

enum (InventorySourceCommitment)

Apakah sumber inventaris memiliki penayangan yang dijamin atau tanpa jaminan.
deliveryMethod

enum (InventorySourceDeliveryMethod)

Metode penayangan sumber inventaris.

  • Untuk sumber inventaris tanpa jaminan, satu-satunya nilai yang dapat diterima adalah INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Untuk sumber inventaris dijamin, nilai yang dapat diterima adalah INVENTORY_SOURCE_DELIVERY_METHOD_TAG dan INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

ID di ruang bursa yang secara unik mengidentifikasi sumber inventaris.

Harus unik di seluruh pembeli dalam setiap bursa, tetapi tidak harus unik di seluruh bursa.
status

object (InventorySourceStatus)

Setelan status sumber inventaris.
exchange

enum (Exchange)

Bursa yang memiliki sumber inventaris.
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat sumber inventaris terakhir diperbarui. Ditetapkan oleh sistem.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
rateDetails

object (RateDetails)

Wajib. Detail tarif sumber inventaris.
publisherName

string

Nama penayang/penjual sumber inventaris.
timeRange

object (TimeRange)

Rentang waktu saat sumber inventaris ini mulai dan berhenti ditayangkan.
creativeConfigs[]

object (CreativeConfig)

Persyaratan materi iklan sumber inventaris.

Tidak berlaku untuk paket lelang.
guaranteedOrderId

string

Tidak dapat diubah. ID pesanan dijamin yang memiliki sumber inventaris ini.

Hanya berlaku jika commitment adalah INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

Partner atau pengiklan yang memiliki akses baca/tulis ke sumber inventaris.

Hanya menghasilkan output jika commitment adalah INVENTORY_SOURCE_COMMITMENT_GUARANTEED, yang dalam hal ini aksesor baca/tulis diwarisi dari urutan yang dijamin induk.

Wajib jika commitment adalah INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Jika commitment adalah INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED dan partner ditetapkan dalam kolom ini, semua pengiklan dalam partner ini akan otomatis memiliki akses hanya baca ke sumber inventaris. Pengiklan tersebut tidak akan disertakan dalam readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

Hanya output. ID pengiklan dengan akses hanya baca ke sumber inventaris.
readPartnerIds[]

string (int64 format)

Hanya output. ID partner dengan akses hanya baca ke sumber inventaris.

Semua pengiklan partner di kolom ini mewarisi akses hanya baca ke sumber inventaris.

InventorySourceType

Jenis sumber inventaris yang mungkin.

Enum
INVENTORY_SOURCE_TYPE_UNSPECIFIED Jenis sumber inventaris tidak ditentukan atau tidak dikenal dalam versi ini.
INVENTORY_SOURCE_TYPE_PRIVATE Sumber inventaris pribadi.
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE Paket lelang.

InventorySourceProductType

Kemungkinan jenis produk dari sumber inventaris.

Enum
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED Jenis produk tidak ditentukan atau tidak dikenal dalam versi ini. Mengubah sumber inventaris jenis produk ini tidak didukung melalui API.
PREFERRED_DEAL Sumber inventaris menjual inventaris melalui Transaksi Pilihan.
PRIVATE_AUCTION Sumber inventaris menjual inventaris melalui Lelang Pribadi.
PROGRAMMATIC_GUARANTEED Sumber inventaris menjual inventaris melalui Dijamin Terprogram.
TAG_GUARANTEED Sumber inventaris menjual inventaris melalui Dijamin oleh Tag.
YOUTUBE_RESERVE Sumber inventaris menjual inventaris melalui YouTube Reserve.
INSTANT_RESERVE Sumber inventaris menjual inventaris melalui Reservasi Instan. Mengubah sumber inventaris jenis produk ini tidak didukung melalui API.
GUARANTEED_PACKAGE Sumber inventaris menjual inventaris melalui Paket Jaminan. Mengubah sumber inventaris jenis produk ini tidak didukung melalui API.
PROGRAMMATIC_TV Sumber inventaris menjual inventaris melalui Programmtic TV. Mengubah sumber inventaris jenis produk ini tidak didukung melalui API.
AUCTION_PACKAGE Sumber inventaris menjual inventaris melalui Paket Lelang. Mengubah sumber inventaris jenis produk ini tidak didukung melalui API.

InventorySourceCommitment

Kemungkinan jenis komitmen untuk sumber inventaris.

Enum
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED Komitmen tidak ditentukan atau tidak dikenal dalam versi ini.
INVENTORY_SOURCE_COMMITMENT_GUARANTEED Komitmen adalah jaminan pengiriman.
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED Komitmen tersebut adalah pengiriman tanpa jaminan.

InventorySourceDeliveryMethod

Metode penayangan yang memungkinkan untuk sumber inventaris.

Enum
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED Metode pengiriman tidak ditentukan atau tidak dikenal pada versi ini.
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC Metode penayangannya terprogram.
INVENTORY_SOURCE_DELIVERY_METHOD_TAG Metode penayangannya adalah tag.

InventorySourceStatus

Setelan terkait status sumber inventaris.

Representasi JSON 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}
Kolom
entityStatus

enum (EntityStatus)

Apakah sumber inventaris dapat ditayangkan atau tidak.

Nilai yang dapat diterima adalah ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED, dan ENTITY_STATUS_PAUSED. Nilai defaultnya adalah ENTITY_STATUS_ACTIVE.
entityPauseReason

string

Alasan yang diberikan pengguna menjeda sumber inventaris ini.

Tidak boleh lebih dari 100 karakter.

Hanya berlaku jika entityStatus ditetapkan ke ENTITY_STATUS_PAUSED.
sellerStatus

enum (EntityStatus)

Hanya output. Status yang ditetapkan oleh penjual untuk sumber inventaris.

Hanya berlaku untuk sumber inventaris yang disinkronkan langsung dari penayang. Nilai yang dapat diterima adalah ENTITY_STATUS_ACTIVE dan ENTITY_STATUS_PAUSED.
sellerPauseReason

string

Hanya output. Alasan yang diberikan penjual untuk menjeda sumber inventaris ini.

Hanya berlaku untuk sumber inventaris yang disinkronkan langsung dari penayang dan jika sellerStatus ditetapkan ke ENTITY_STATUS_PAUSED.
configStatus

enum (InventorySourceConfigStatus)

Hanya output. Status konfigurasi sumber inventaris.

Hanya berlaku untuk sumber inventaris dijamin. Nilai yang dapat diterima adalah INVENTORY_SOURCE_CONFIG_STATUS_PENDING dan INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED.

Sumber inventaris harus dikonfigurasi (isi kolom wajib diisi, pilih materi iklan, dan pilih kampanye default) sebelum dapat ditayangkan.

InventorySourceConfigStatus

Kemungkinan status konfigurasi untuk sumber inventaris dijamin.

Enum
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED Status persetujuan tidak ditentukan atau tidak diketahui pada versi ini.
INVENTORY_SOURCE_CONFIG_STATUS_PENDING Status awal sumber inventaris dijamin. Sumber inventaris dalam status ini perlu dikonfigurasi.
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED Status setelah pembeli mengonfigurasi sumber inventaris dijamin.

RateDetails

Setelan terkait tarif dari sumber inventaris.

Representasi JSON 
{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}
Kolom
inventorySourceRateType

enum (InventorySourceRateType)

Jenis tarif.

Nilai yang dapat diterima adalah INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR, dan INVENTORY_SOURCE_RATE_TYPE_CPD.
rate

object (Money)

Tarif untuk sumber inventaris.
unitsPurchased

string (int64 format)

Wajib untuk sumber inventaris dijamin. Jumlah tayangan yang dijamin oleh penjual.
minimumSpend

object (Money)

Hanya output. Jumlah komitmen pembeli untuk membelanjakan sumber inventaris di awal.

Hanya berlaku untuk sumber inventaris dijamin.

InventorySourceRateType

Jenis tarif yang mungkin untuk sumber inventaris.

Enum
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED Jenis tarif tidak ditentukan atau tidak diketahui dalam versi ini.
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED Jenis tarifnya adalah CPM (Tetap).
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR Jenis tarifnya adalah CPM (Harga minimum).
INVENTORY_SOURCE_RATE_TYPE_CPD Jenis tarifnya adalah Biaya per Hari.
INVENTORY_SOURCE_RATE_TYPE_FLAT Jenis tarifnya adalah Tetap.

Uang

Menyatakan jumlah uang dengan jenis mata uangnya.

Representasi JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Kolom
currencyCode

string

Tiga huruf kode mata uang yang ditentukan dalam ISO 4217.
units

string (int64 format)

Seluruh unit jumlah. Misalnya jika currencyCode adalah "USD", maka 1 unit adalah satu dolar AS.
nanos

integer

Jumlah satuan nano (10^-9) dari jumlah tersebut. Nilai harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos bisa positif, nol, atau negatif. Jika units negatif, nanos harus negatif, atau nol. Misalnya,$-1,75 direpresentasikan sebagai units=-1 dan nanos=-750.000.000.

TimeRange

Rentang waktu.

Representasi JSON 
{
  "startTime": string,
  "endTime": string
}
Kolom
startTime

string (Timestamp format)

Wajib. Batas bawah rentang waktu, inklusif.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Wajib. Batas atas rentang waktu, inklusif.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

CreativeConfig

Konfigurasi persyaratan materi iklan untuk sumber inventaris.

Representasi JSON 
{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}
Kolom
creativeType

enum (CreativeType)

Jenis materi iklan yang dapat ditetapkan ke sumber inventaris. Hanya jenis berikut yang didukung:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

Kolom union creative_config_scheme. Berlaku jika creative_type adalah salah satu dari:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

Konfigurasi untuk materi iklan yang dapat ditetapkan ke sumber inventaris. creative_config_scheme hanya dapat berupa salah satu dari berikut:
displayCreativeConfig

object (InventorySourceDisplayCreativeConfig)

Konfigurasi untuk materi iklan display. Berlaku jika creativeType adalah CREATIVE_TYPE_STANDARD.
videoCreativeConfig

object (InventorySourceVideoCreativeConfig)

Konfigurasi untuk materi iklan video. Berlaku jika creativeType adalah CREATIVE_TYPE_VIDEO.

InventorySourceDisplayCreativeConfig

Konfigurasi untuk materi iklan display.

Representasi JSON 
{
  "creativeSize": {
    object (Dimensions)
  }
}
Kolom
creativeSize

object (Dimensions)

Persyaratan ukuran untuk materi iklan display yang dapat ditetapkan ke sumber inventaris.

InventorySourceVideoCreativeConfig

Konfigurasi untuk materi iklan video.

Representasi JSON 
{
  "duration": string
}
Kolom
duration

string (Duration format)

Persyaratan durasi untuk materi iklan video yang dapat ditetapkan ke sumber inventaris.

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

InventorySourceAccessors

Partner atau pengiklan yang memiliki akses ke sumber inventaris.

Representasi JSON 
{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}
Kolom
Kolom union accessors. Partner atau pengiklan yang memiliki akses ke sumber inventaris. accessors hanya ada berupa salah satu diantara berikut:
partner

object (PartnerAccessor)

Partner dengan akses ke sumber inventaris.
advertisers

object (AdvertiserAccessors)

Pengiklan yang memiliki akses ke sumber inventaris. Semua pengiklan harus berasal dari partner yang sama.

PartnerAccessor

Partner dengan akses ke sumber inventaris.

Representasi JSON 
{
  "partnerId": string
}
Kolom
partnerId

string (int64 format)

ID partner.

AdvertiserAccessors

Pengiklan yang memiliki akses ke sumber inventaris.

Representasi JSON 
{
  "advertiserIds": [
    string
  ]
}
Kolom
advertiserIds[]

string (int64 format)

ID pengiklan.

Metode

create

 Membuat sumber inventaris baru.

editInventorySourceReadWriteAccessors

 Mengedit pengakses baca/tulis dari sumber inventaris.

get

 Mendapatkan sumber inventaris.

list

 Mencantumkan sumber inventaris yang dapat diakses oleh pengguna saat ini.

patch

 Memperbarui sumber inventaris yang ada.