REST Resource: exchanges.auctionPackages

المورد: AuctionPackage

تتضمّن هذه السمة حزمة مزاد واحدة. يمكن للمعلِنين في DV3 استعراض جميع حِزم المزادات في DV3 من خلال واجهة مستخدم "اكتشاف السوق" والموافقة على استخدام هذه الحِزم بدون اتّخاذ أي إجراء من قِبل البائع.

تمثيل 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} Example: "exchanges/1234/auctionPackage/5678". النتائج فقط.
displayName

string

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

enum (DiscoveryObjectStatus)

الحقل مطلوب. تمثّل هذه السمة حالة حزمة المزاد. لا يتم عرض الحِزم التي تحمل الحالة PAUSED أو REMOVED للمعلِنين على "مساحة العرض والفيديو 360". الحقل مطلوب.
description

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

اختياريّ. تقسيم التوقّعات لمستودع حزمة المزاد هذه يمكن للمعلِنين على "مساحة العرض والفيديو 360" الاطّلاع على هذه التقسيمات وفلترتها. اختياريّ.
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

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

التنسيق

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

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

الطُرق

create

 تنشئ هذه الطريقة حزمة مزايدة جديدة.

get

 يحصل على حزمة مزاد.

list

 تعرض هذه الطريقة حِزم المزادات.

patch

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