REST Resource: advertisers.manualTriggers

المرجع: manualTrigger

عامل تشغيل يدوي واحد في "مساحة العرض والفيديو 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

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