Method: exchanges.auctionPackages.patch

Memperbarui paket lelang.

Permintaan HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
auctionPackage.name

string

Nama rute relatif untuk paket lelang ini. Harus dalam format: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Contoh: "exchanges/1234/auctionPackage/5678". Hanya output.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Kolom
auctionPackage.displayName

string

Nama tampilan paket lelang ini. Harus berenkode UTF-8 dengan ukuran maksimum 240 karakter. Wajib.
auctionPackage.status

enum (DiscoveryObjectStatus)

Status paket lelang ini. Paket dengan status DIJEDA atau DIHAPUS tidak ditampilkan kepada pengiklan DV3. Wajib.
auctionPackage.description

string

Teks deskripsi untuk paket ini. Harus berenkode UTF-8 dengan ukuran maksimum 2.000 karakter. Wajib.
auctionPackage.format

enum (Format)

Jenis format iklan yang mendasarinya. Wajib. Pembaruan tidak diizinkan setelah pembuatan.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Perincian perkiraan untuk inventaris paket lelang ini. Pengiklan DV3 dapat melihat dan memfilter perincian ini. Opsional.
auctionPackage.externalDealId

string

ID transaksi bursa yang digunakan dalam permintaan bid. Maksimum 100 karakter. Karakter yang diizinkan adalah alfanumerik, garis bawah, tanda hubung, dan titik. Wajib. Wajib. Tidak mengizinkan pembaruan setelah pembuatan.
auctionPackage.logoUrl

string

Hanya output. URL untuk logo paket lelang ini.

Hanya output.
auctionPackage.floorPrice

object (Money)

Harga minimum paket lelang ini. Wajib.
auctionPackage.startTime

string (Timestamp format)

Waktu saat produk ini menjadi aktif. Harus lebih awal dari endTime. Waktu mulai tidak boleh lebih dari 1 tahun ke depan. Wajib.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
auctionPackage.endTime

string (Timestamp format)

Waktu saat produk ini menjadi tidak aktif. Wajib.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
auctionPackage.mediumType

enum (MediumType)

Wajib. Jenis media paket lelang.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Opsional. Grup yang kurang terwakili yang anggotanya adalah pemilik, jika ada.
updateMask

string (FieldMask format)

Mask untuk mengontrol kolom yang akan diperbarui. Wajib.

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

Hanya output. Link Dv360 untuk paket lelang di marketplace.

Isi respons

Jika berhasil, isi respons memuat instance AuctionPackage.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.