Method: exchanges.auctionPackages.patch

Memperbarui paket lelang.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
auctionPackage.name

string

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

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

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

enum (DiscoveryObjectStatus)

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

string

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

enum (Format)

Wajib. Tidak dapat diubah. Jenis format iklan pokok. Update tidak diizinkan setelah pembuatan.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

string

Hanya output. URL untuk logo paket lelang ini.
auctionPackage.floorPrice

object (Money)

Wajib. Harga minimum paket lelang ini.
auctionPackage.startTime

string (Timestamp format)

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

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. 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)

Wajib. Waktu saat produk ini menjadi tidak aktif.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. 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 pemiliknya adalah anggota, jika ada.
updateMask

string (FieldMask format)

Opsional. Mask untuk mengontrol kolom yang akan diperbarui.

Ini adalah comma-separated list berisi 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.