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/{customerId}/profiles/{profilePermanentId}/commands/{command_id}
commandType

string

الحقل مطلوب. نوع الأمر عن بُعد. الأوامر المتوافقة: "clearBrowsingData" و "extensionUpdateCheck".
payload

object (Struct format)

الحقل مطلوب. حمولة الأمر عن بُعد

يتيح حمولة الأمر "clearBrowsingData" ما يلي: - الحقلان "clearCache" و "clearCookies" - قيم من النوع المنطقي.

يجب أن تكون حمولة "extensionUpdateCheck" فارغة.
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.