Method: exchanges.auctionPackages.patch

بسته حراج را به روز می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
auctionPackage.name

string

نام مسیر نسبی برای این بسته حراج. باید به این شکل باشد: "exchanges/{seller_id}/auctionpackages/{auction_package_id} مثال: "exchanges/1234/auctionPackage/5678". فقط خروجی.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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
}
فیلدها
auctionPackage.displayName

string

نام نمایشی این بسته حراج. باید دارای کد UTF-8 با حداکثر اندازه 240 کاراکتر باشد. مورد نیاز.

auctionPackage.status

enum ( DiscoveryObjectStatus )

وضعیت این بسته حراج. بسته‌های دارای وضعیت موقتاً متوقف یا حذف شده به تبلیغ‌کنندگان DV3 نشان داده نمی‌شوند. مورد نیاز.

auctionPackage.description

string

متن توضیحات این بسته باید دارای کد UTF-8 با حداکثر اندازه 2000 کاراکتر باشد. مورد نیاز.

auctionPackage.format

enum ( Format )

نوع قالب آگهی زیربنایی. مورد نیاز. به روز رسانی پس از ایجاد مجاز نیست.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

پیش بینی تفکیک موجودی این بسته حراج. تبلیغ‌کنندگان DV3 می‌توانند این تفکیک‌ها را ببینند و فیلتر کنند. اختیاری.

auctionPackage.externalDealId

string

شناسه معامله مبادله ای که در درخواست های پیشنهادی استفاده می شود. حداکثر 100 کاراکتر کاراکترهای مجاز عبارتند از حروف عددی، زیرخط، خط تیره و نقطه. مورد نیاز. مورد نیاز. به روز رسانی پس از ایجاد اجازه نمی دهد.

auctionPackage.logoUrl

string

فقط خروجی نشانی اینترنتی لوگوی این بسته حراج.

فقط خروجی

auctionPackage.floorPrice

object ( Money )

قیمت کف این بسته حراج. مورد نیاز.

auctionPackage.startTime

string ( Timestamp format)

زمانی که این محصول فعال می شود. باید زودتر از پایان زمان باشد. زمان شروع نمی تواند بیش از 1 سال در آینده باشد. مورد نیاز.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

auctionPackage.endTime

string ( Timestamp format)

زمانی که این محصول غیر فعال می شود. مورد نیاز.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

auctionPackage.mediumType

enum ( MediumType )

مورد نیاز. نوع متوسط ​​بسته حراج.

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

اختیاری. در گروه‌های ارائه‌شده، مالک، در صورت وجود، عضوی است.

updateMask

string ( FieldMask format)

ماسکی برای کنترل اینکه کدام فیلدها به روز شوند. مورد نیاز.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

auctionPackage.dv3MarketplaceUri

string

فقط خروجی لینک Dv360 برای بسته حراج در بازار.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه از AuctionPackage است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .