REST Resource: customers.profiles.commands

المرجع: ChromeBrowserProfileCommand

تمثيل لأمر عن بُعد لملف شخصي في متصفِّح Chrome

تمثيل JSON 
{
  "name": string,
  "commandType": string,
  "payload": {
    object
  },
  "commandState": enum (CommandState),
  "commandResult": {
    object (CommandResult)
  },
  "issueTime": string,
  "validDuration": string
}
الحقول
name

string

المعرّف التنسيق: customers/{customer_id}/profiles/{profilePermanentId}/commands/{command_id}
commandType

string

مطلوب. نوع الأمر عن بُعد لا يمكن استخدام سوى النوع "clearBrowsingData" لعنصر commandType.
payload

object (Struct format)

مطلوب. حمولة الأمر عن بُعد تتيح الحمولة لأمر clearBrowsingData ما يلي: - الحقلَين clearCache وclearCookies - قيم من النوع المنطقي.
commandState

enum (CommandState)

النتائج فقط. حالة الأمر عن بُعد
commandResult

object (CommandResult)

النتائج فقط. نتيجة تنفيذ الأمر عن بُعد
issueTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لإصدار الأمر عن بُعد

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر التي لا تُعدّ "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
validDuration

string (Duration format)

النتائج فقط. مدة صالحة للأمر عن بُعد

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".

CommandState

الحالات المحتمَلة لطلب معيّن

عمليات التعداد
COMMAND_STATE_UNSPECIFIED يمثّل حالة أمر غير محدَّدة.
PENDING يمثّل طلبًا في حالة انتظار.
EXPIRED يمثّل أمرًا انتهت صلاحيته.
EXECUTED_BY_CLIENT يمثّل أمرًا نفَّذه العميل.

CommandResult

نتيجة تنفيذ أمر

تمثيل JSON 
{
  "resultType": enum (CommandResultType),
  "clientExecutionTime": string,
  "resultCode": string
}
الحقول
resultType

enum (CommandResultType)

النتائج فقط. نوع نتيجة الأمر عن بُعد
clientExecutionTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لتنفيذ العميل للأمر عن بُعد

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
resultCode

string

النتائج فقط. رمز النتيجة الذي يشير إلى نوع الخطأ أو نجاح الأمر

CommandResultType

أنواع النتائج المحتمَلة لطلب معيّن

عمليات التعداد
COMMAND_RESULT_TYPE_UNSPECIFIED يمثّل نتيجة أمر غير محدّدة.
IGNORED يمثّل أمرًا يتضمّن نتيجة تم تجاهلها.
FAILURE يمثّل طلبًا تعذّر تنفيذه.
SUCCESS يمثّل أمرًا ناجحًا.

الطُرق

create

 تُنشئ هذه الوظيفة أمرًا عن بُعد لملف شخصي في متصفِّح Chrome.

get

 الحصول على أمر عن بُعد لملف شخصي في متصفّح Chrome

list

 يعرض الأوامر عن بُعد لملف شخصي في متصفّح Chrome.