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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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