Method: exchanges.auctionPackages.patch

Bir 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

Tanımlayıcı. Bu açık artırma paketinin göreli rota adı. Şu biçimde olmalıdır: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Örneğin: "exchanges/1234/auctionPackage/5678".

İstek metni

İstek içeriği 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

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

enum (DiscoveryObjectStatus)

Zorunlu. Bu açık artırma paketinin durumu. Durumu DURAKLATILDI veya KALDIRILDI olan paketler DV3 reklamverenlerine gösterilmez.
auctionPackage.description

string

Zorunlu. Bu paketin açıklama metni. En fazla 2.000 karakter boyutunda UTF-8 kodlu olmalıdır.
auctionPackage.format

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

Zorunlu. Değişmez. Teklif isteklerinde kullanılan exchange anlaşması kimliği. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve nokta şeklindedir. Oluşturulduktan sonra güncellemelere izin verilmez.
auctionPackage.logoUrl

string

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

object (Money)

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

string (Timestamp format)

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

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da 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)

Zorunlu. Bu ürünün devre dışı kalacağı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da 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 ortam türü.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

İsteğe bağlı. Sahibin üyesi olduğu, yeterince temsil edilmeyen gruplar (varsa)
updateMask

string (FieldMask format)

İsteğe bağlı. Hangi alanların güncelleneceğini kontrol etmek için kullanılan maske.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış 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 metni

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.