REST Resource: advertisers.manualTriggers

المرجع: المشغِّل اليدوي

عامل تشغيل يدوي واحد في "مساحة العرض والفيديو 360".

تحذير: إنّ العناصر التي تستخدم عوامل التشغيل اليدوية لم تعُد معروضة في "مساحة العرض والفيديو 360". سيتم إيقاف هذا المرجع نهائيًا في 1 آب (أغسطس) 2023. يمكنك الاطّلاع على الإشعار عن إيقاف الميزات نهائيًا للحصول على مزيد من المعلومات.

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "triggerId": string,
  "displayName": string,
  "activationDurationMinutes": string,
  "latestActivationTime": string,
  "state": enum (State)
}
الحقول
name

string

النتائج فقط. اسم المورد للعامل المشغِّل اليدوي.
advertiserId

string (int64 format)

مطلوبة. غير قابل للتغيير. رقم التعريف الفريد للمعلِن الذي ينتمي إليه عامل التفعيل اليدوي.
triggerId

string (int64 format)

النتائج فقط. المعرّف الفريد للعامل المشغِّل اليدوي.
displayName

string

مطلوبة. الاسم المعروض للعامل المشغِّل اليدوي

يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى.
activationDurationMinutes

string (int64 format)

مطلوبة. الحد الأقصى لمدة كل عملية تفعيل بالدقائق. يجب أن تتراوح القيمة بين 1 و360. وبعد هذه المدة، سيتم إيقاف العامل المشغِّل تلقائيًا.
latestActivationTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر عملية تفعيل للمشغّل

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

enum (State)

النتائج فقط. حالة عامل التفعيل اليدوي سيتم ضبطه على الحالة INACTIVE عند الإنشاء.

الحالة

حالة المشغِّل اليدوي.

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية عندما تكون الحالة غير محدّدة أو غير معروفة في هذا الإصدار.
INACTIVE المشغِّل غير نشط حاليًا وجاهز للتفعيل.
ACTIVE عامل التفعيل نشط حاليًا (مفعّل).

الطُرق

activate

 تفعيل عامل تشغيل يدوي

create

 ستؤدي إلى إنشاء عامل تشغيل يدوي جديد.

deactivate

 لإيقاف المشغِّل اليدوي.

get

 يتم استخدام عامل تشغيل يدوي.

list

 يسرد عوامل التحفيز اليدوية التي يمكن للمستخدِم الحالي الوصول إليها للرقم التعريفي للمعلِن المعيّن.

patch

 لتعديل المشغِّل اليدوي