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

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