REST Resource: exchanges.auctionPackages

المرجع: AuctionPackage

تُغلِّف حزمة مزاد واحدة. يمكن للمعلِنين في "حملات الفيديو أثناء التصفّح 3" تصفُّح جميع حِزم المزادات في "حملات الفيديو أثناء التصفّح 3" من خلال واجهة مستخدِم "الاكتشاف في السوق" وتفعيل استخدام هذه الحِزم بدون اتّخاذ أيّ إجراء من قِبل البائع.

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
الحقول
name

string

اسم المسار النسبي لحزمة المزاد هذه. يجب أن يكون على النحو التالي: "exchanges/{seller_id}/auctionpackages/{auction_package_id}". على سبيل المثال: "exchanges/1234/auctionPackage/5678". النتائج فقط.
displayName

string

الاسم المعروض لحزمة المزاد هذه. يجب أن يكون الترميز UTF-8 بحد أقصى 240 حرفًا. مطلوب.
status

enum (DiscoveryObjectStatus)

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

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

string

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

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

object (Money)

السعر الأدنى لحزمة المزاد هذه. مطلوب.
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"
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"
mediumType

enum (MediumType)

مطلوب. نوع الوسيط لحزمة المزاد.
urgOwners[]

enum (UnderRepresentedGroup)

اختياريّ. ضمن المجموعات المعنيّة، يشير ذلك إلى المجموعات التي يكون المالك عضوًا فيها، إن توفّرت.
dv3MarketplaceUri

string

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

التنسيق

شكل الإعلان لحزمة المزاد

عمليات التعداد
DEAL_FORMAT_UNSPECIFIED لم يتم تحديد تنسيق الصفقة. غير صالحة للإدخال.
DEAL_FORMAT_DISPLAY تنسيق العرض
DEAL_FORMAT_VIDEO تنسيق الفيديو
DEAL_FORMAT_AUDIO تنسيق الصوت

الطُرق

create

 لإنشاء حزمة مزاد جديدة.

get

 الحصول على حزمة مزاد

list

 يعرض حِزم المزادات.

patch

 تعديل حزمة مزاد
حمِّل شعار الحزمة المحدّدة.