Method: exchanges.auctionPackages.patch

تعديل حزمة مزاد

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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 بحد أقصى 240 حرفًا. مطلوب.
auctionPackage.status

enum (DiscoveryObjectStatus)

حالة حزمة المزاد هذه. لا تظهر الحِزم التي تحمل الحالة "متوقفة مؤقتًا" أو "تمت إزالتها" لمعلِني DV3. مطلوب.
auctionPackage.description

string

نص الوصف لهذه الحزمة يجب أن يكون الترميز UTF-8 بحد أقصى 2000 حرف. مطلوب.
auctionPackage.format

enum (Format)

نوع شكل الإعلان الأساسي. مطلوب. لا يُسمح بإجراء تعديلات بعد الإنشاء.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

تفاصيل التوقّعات لمستودع حزمة المزاد هذه يمكن للمعلِنين في "الحملات على شبكة البحث" من الجيل الثالث الاطّلاع على هذه التصنيفات وفلترتها. اختياريّ.
auctionPackage.externalDealId

string

رقم تعريف صفقة الصرف المستخدَم في طلبات عروض الأسعار. يمكن استخدام 100 حرف كحدّ أقصى. الأحرف المسموح بها هي الأحرف الأبجدية الرقمية والشرطة السفلية والشرطة والنقطة. مطلوب. مطلوب. عدم السماح بإجراء تعديلات بعد الإنشاء
auctionPackage.logoUrl

string

النتائج فقط. عنوان URL لشعار حزمة المزاد هذه.

النتائج فقط.
auctionPackage.floorPrice

object (Money)

السعر الأدنى لحزمة المزاد هذه. مطلوب.
auctionPackage.startTime

string (Timestamp format)

الوقت الذي يصبح فيه هذا المنتج نشطًا. يجب أن يكون قبل endTime. لا يمكن أن يكون وقت البدء بعد أكثر من عام واحد في المستقبل. مطلوب.

يستخدم معيار 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

النتائج فقط. رابط "مساحة العرض والفيديو 360" لحزمة المزاد في السوق

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال AuctionPackage.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.