REST Resource: availabilityOrders.availabilityLines

المورد: availabilityLine

يمثل سطر مدى التوفّر مجموعة من الإعدادات التي يطلب المشتري من خلالها معرفة مدى توفّر المستودع والردّ من البائع. لسير العمل، يُرجى الاطّلاع على AvailabilityOrder.

تمثيل JSON 
{
  "name": string,
  "product": string,
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
الحقول
name

string

النتائج فقط. تمثّل هذه السمة اسم المورد لسطر مدى التوفّر بالتنسيق: availabilityOrders/123/availabilityLines/321.
product

string

النتائج فقط. اسم Product المخصّص لطلب مدى التوفّر هذا التنسيق = منتجات/456
startTime
(deprecated)

string (Timestamp format)

النتائج فقط. تمثّل هذه السمة وقت بدء طلب مدى التوفّر (شامل).

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
endTime
(deprecated)

string (Timestamp format)

النتائج فقط. تمثّل هذه السمة وقت انتهاء طلب مدى التوفّر (غير شامل).

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
startDate

object (Date)

النتائج فقط. تاريخ البدء الذي تم فيه طلب مدى التوفّر (شامل) المنطقة الزمنية نفسها للوحدة الإعلانية.
endDate

object (Date)

النتائج فقط. تاريخ انتهاء طلب مدى التوفّر (شامل) المنطقة الزمنية نفسها للوحدة الإعلانية.
budget

object (Money)

النتائج فقط. تمثّل هذه السمة ميزانية سطر مدى التوفّر.
targeting

object (Targeting)

النتائج فقط. الاستهداف المطلوب مدى التوفّر.
availabilityLineTerms

object (LineTerms)

النتائج فقط. يمكن للبائع استخدام [إكمال][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] لتعديل [Line terms].
state

enum (State)

النتائج فقط. تمثّل هذه السمة حالة طلب مدى التوفّر هذا. يمكنك الانتقال إلى AvailabilityLine.State للاطّلاع على مراحل نشاط خط AvailabilityLine.

يمكن للبائع استخدام الطريقة [إكمال][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] أو [رفض][google.ads.xbid.outofhome.v1beta1.OrderManagementService.RejectAvailabilityLine] للضبط على أحد الخيارات التالية:

  • STATE_COMPLETED
  • STATE_REJECTED

على التوالي.
rejection

object (Rejection)

تفاصيل الرفض لسطر مدى التوفّر
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لإنشاء سطر مدى التوفّر.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

النتائج فقط. تاريخ آخر تعديل لخط مدى التوفّر

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

الحالة

القيم المحتملة لحالة سطر التوفّر

عمليات التعداد
STATE_UNSPECIFIED تكون القيمة التلقائية عندما لا يتم تحديد حالة سطر مدى التوفّر أو تكون غير معروفة في هذا الإصدار.
STATE_PENDING في انتظار مدى التوفّر عندما قدّم المشتري إعدادات طلب التوفّر.
STATE_COMPLETED حالة مكتملة عندما قدّم البائع الرد بشأن مدى التوفّر.
STATE_REJECTED حالة الرفض عندما رفض البائع سطر مدى التوفّر. ويجب تقديم تفاصيل الرفض.
STATE_CANCELLED حالة الإلغاء عندما يلغي المشتري الطلب قبل إكمال البائع أو رفض الرد على مدى التوفّر.

الطُرق

complete

 وضع علامة "مكتمل" على سطر مدى التوفّر الحالي

get

 لاسترداد سطر فردي لطلب مدى التوفّر.

list

 يسرد سطورًا لطلب مدى التوفّر.

reject

 وضع علامة "مرفوض" على سطر مدى التوفّر الحالي