Method: exchanges.auctionPackages.patch

Açık artırma paketini günceller.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
auctionPackage.name

string

Bu açık artırma paketinin göreli rota adı. "exchanges/{seller_id}/auctionpackages/{auction_package_id}" biçiminde olmalıdır. Örnek: "exchanges/1234/auctionPackage/5678". Yalnızca çıkış.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "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
}
Alanlar
auctionPackage.displayName

string

Bu açık artırma paketinin görünen adı. UTF-8 kodlu olmalı ve en fazla 240 karakter uzunluğunda olmalıdır. Zorunlu.
auctionPackage.status

enum (DiscoveryObjectStatus)

Bu açık artırma paketinin durumu. DURDURULDU veya KALDIRILDI durumuna sahip paketler DV3 reklamverenlere gösterilmez. Zorunlu.
auctionPackage.description

string

Bu paketin açıklama metni. UTF-8 kodlu olmalı ve en fazla 2.000 karakter uzunluğunda olmalıdır. Zorunlu.
auctionPackage.format

enum (Format)

Temel reklam biçimi türü. Zorunlu. Oluşturulduktan sonra güncellemelere izin verilmez.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Bu açık artırma paketinin envanteri için tahmin dökümü. DV3 reklamverenleri bu dökümleri görebilir ve filtreleyebilir. İsteğe bağlı.
auctionPackage.externalDealId

string

Teklif isteklerinde kullanılan exchange anlaşma kimliği. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır. Zorunlu. Zorunlu. Oluşturulduktan sonra güncellemelere izin vermez.
auctionPackage.logoUrl

string

Yalnızca çıkış. Bu açık artırma paketinin logosunun URL'si.

Yalnızca çıkış.
auctionPackage.floorPrice

object (Money)

Bu açık artırma paketinin taban fiyatı. Zorunlu.
auctionPackage.startTime

string (Timestamp format)

Bu ürünün etkinleştiği zaman. endTime değerinden önce olmalıdır. Başlangıç zamanı en fazla 1 yıl sonrası olabilir. Zorunlu.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
auctionPackage.endTime

string (Timestamp format)

Bu ürünün etkin olmadığı zaman. Zorunlu.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
auctionPackage.mediumType

enum (MediumType)

Zorunlu. Açık artırma paketinin medya türü.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

İsteğe bağlı. Sahibinin üyesi olduğu az temsil edilen gruplar (varsa).
updateMask

string (FieldMask format)

Hangi alanların güncelleneceğini kontrol eden maske. Zorunlu.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

Yalnızca çıkış. Pazar yerindeki açık artırma paketi için DV360 bağlantısı.

Yanıt gövdesi

Başarılıysa yanıt metni, AuctionPackage öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.