REST Resource: inventorySources

{
  "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
  ]
}

string

Hanya output. Nama resource sumber inventaris.

string (int64 format)

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

string

Nama tampilan sumber inventaris.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

enum (InventorySourceType)

Menunjukkan jenis sumber inventaris.

enum (InventorySourceProductType)

Hanya output. Jenis produk sumber inventaris, yang menunjukkan cara penjualan inventaris.

enum (InventorySourceCommitment)

Apakah sumber inventaris memiliki penayangan yang dijamin atau tanpa jaminan.

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.

string

ID di ruang bursa yang mengidentifikasi sumber inventaris secara unik.

Harus unik di antara pembeli dalam setiap bursa, tetapi tidak harus unik di berbagai bursa.

object (InventorySourceStatus)

Setelan status sumber inventaris.

enum (Exchange)

Bursa yang mencakup sumber inventaris.

string (Timestamp format)

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

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

object (RateDetails)

Wajib diisi. Detail tarif sumber inventaris.

string

Nama penayang/penjual sumber inventaris.

object (TimeRange)

Rentang waktu saat sumber inventaris ini mulai dan berhenti ditayangkan.

object (CreativeConfig)

Persyaratan materi iklan sumber inventaris.

Tidak berlaku untuk paket lelang.

string

Tidak dapat diubah. ID pesanan yang dijamin tempat sumber inventaris ini berada.

Hanya berlaku jika commitment adalah INVENTORY_SOURCE_COMMITMENT_GUARANTEED.

object (InventorySourceAccessors)

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

Output hanya jika commitment adalah INVENTORY_SOURCE_COMMITMENT_GUARANTEED, dalam hal ini pengakses 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 di kolom ini, semua pengiklan di bawah partner ini akan otomatis memiliki akses hanya baca ke sumber inventaris. Pengiklan ini tidak akan disertakan dalam readAdvertiserIds.

string (int64 format)

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

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.

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

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.

string

Alasan yang diberikan pengguna untuk menjeda sumber inventaris ini.

Tidak boleh lebih dari 100 karakter.

Hanya berlaku jika entityStatus ditetapkan ke ENTITY_STATUS_PAUSED.

enum (EntityStatus)

Hanya output. Status yang ditetapkan 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.

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 disetel ke ENTITY_STATUS_PAUSED.

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 (mengisi kolom wajib diisi, memilih materi iklan, dan memilih kampanye default) sebelum dapat ditayangkan.

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

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.

object (Money)

Tarif untuk sumber inventaris.

string (int64 format)

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

object (Money)

Hanya output. Jumlah yang telah berkomitmen untuk dibelanjakan pada sumber inventaris oleh pembeli di awal.

Hanya berlaku untuk sumber inventaris dijamin.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Kode mata uang tiga huruf yang ditentukan dalam ISO 4217.

string (int64 format)

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

integer

Jumlah unit nano (10^-9) dari jumlah tersebut. Nilainya 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.

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

Wajib diisi. Batas bawah rentang waktu, inklusif.

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

string (Timestamp format)

Wajib diisi. Batas atas rentang waktu, inklusif.

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

{
  "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.
}

enum (CreativeType)

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

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object (InventorySourceDisplayCreativeConfig)

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

object (InventorySourceVideoCreativeConfig)

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

{
  "creativeSize": {
    object (Dimensions)
  }
}

object (Dimensions)

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

{
  "duration": string
}

string (Duration format)

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

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

{

  // 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.
}

object (PartnerAccessor)

Partner dengan akses ke sumber inventaris.

object (AdvertiserAccessors)

Pengiklan yang memiliki akses ke sumber inventaris. Semua pengiklan harus menjadi milik partner yang sama.

{
  "partnerId": string
}

string (int64 format)

ID partner.

{
  "advertiserIds": [
    string
  ]
}

string (int64 format)

ID pengiklan.