Method: exchanges.auctionPackages.patch

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
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 و حداکثر اندازه ۲۴۰ کاراکتر باشد.

auctionPackage.status

enum ( DiscoveryObjectStatus )

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

auctionPackage.description

string

الزامی. متن توضیحات این بسته. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰۰ کاراکتر باشد.

auctionPackage.format

enum ( Format )

الزامی. تغییرناپذیر. نوع قالب تبلیغ اصلی. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

auctionPackage.externalDealId

string

الزامی. تغییرناپذیر. شناسه معامله صرافی که در درخواست‌های پیشنهاد قیمت استفاده می‌شود. حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

auctionPackage.logoUrl

string

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

auctionPackage.floorPrice

object ( Money )

الزامی. قیمت پایه این بسته حراج.

auctionPackage.startTime

string ( Timestamp format)

الزامی. زمانی که این بسته حراج فعال می‌شود. باید قبل از پایان زمان باشد. زمان شروع نمی‌تواند بیش از ۱ سال آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
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 و حداکثر اندازه ۲۴۰ کاراکتر باشد.

auctionPackage.status

enum ( DiscoveryObjectStatus )

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

auctionPackage.description

string

الزامی. متن توضیحات این بسته. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰۰ کاراکتر باشد.

auctionPackage.format

enum ( Format )

الزامی. تغییرناپذیر. نوع قالب تبلیغ اصلی. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

auctionPackage.externalDealId

string

الزامی. تغییرناپذیر. شناسه معامله صرافی که در درخواست‌های پیشنهاد قیمت استفاده می‌شود. حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

auctionPackage.logoUrl

string

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

auctionPackage.floorPrice

object ( Money )

الزامی. قیمت پایه این بسته حراج.

auctionPackage.startTime

string ( Timestamp format)

الزامی. زمانی که این بسته حراج فعال می‌شود. باید قبل از پایان زمان باشد. زمان شروع نمی‌تواند بیش از ۱ سال آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
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 و حداکثر اندازه ۲۴۰ کاراکتر باشد.

auctionPackage.status

enum ( DiscoveryObjectStatus )

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

auctionPackage.description

string

الزامی. متن توضیحات این بسته. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰۰ کاراکتر باشد.

auctionPackage.format

enum ( Format )

الزامی. تغییرناپذیر. نوع قالب تبلیغ اصلی. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

auctionPackage.externalDealId

string

الزامی. تغییرناپذیر. شناسه معامله صرافی که در درخواست‌های پیشنهاد قیمت استفاده می‌شود. حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

auctionPackage.logoUrl

string

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

auctionPackage.floorPrice

object ( Money )

الزامی. قیمت پایه این بسته حراج.

auctionPackage.startTime

string ( Timestamp format)

الزامی. زمانی که این بسته حراج فعال می‌شود. باید قبل از پایان زمان باشد. زمان شروع نمی‌تواند بیش از ۱ سال آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .