TaskLog

سجل مورد Task في Deliveries API.

تمثيل JSON 
{
  "name": string,
  "type": enum (TaskTypeLog),
  "state": enum (TaskStateLog),
  "taskOutcome": enum (TaskOutcomeLog),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfoLog)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSourceLog),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfoLog)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindowLog)
  },
  "journeySharingInfo": {
    object (JourneySharingInfoLog)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfigLog)
  },
  "attributes": [
    {
      object (TaskAttributeLog)
    }
  ]
}
الحقول
name

string

تمثّل هذه السمة اسم مورد المهام بتنسيق providers/{providerId}/tasks/{taskId}.
type

enum (TaskTypeLog)

نوع المهمة.
state

enum (TaskStateLog)

حالة مهمة تشير إلى تقدمها.
taskOutcome

enum (TaskOutcomeLog)

يشير ذلك المصطلح إلى نتيجة محاولة تنفيذ مهمة. عند إغلاق TaskState، يشير ذلك إلى ما إذا تم إكمالها بنجاح.
taskOutcomeTime

string (Timestamp format)

الطابع الزمني لوقت ضبط نتيجة المهمة (من موفِّر الخدمة).

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
taskOutcomeLocation

object (LocationInfoLog)

هي المكان الذي تم فيه ضبط نتيجة المهمة.
taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

يشير إلى مصدر قيمة taskOutcomeLocation.
trackingId

string

يسهِّل هذا الحقل تخزين المعرّف لتجنُّب عمليات الربط غير الضرورية أو المعقّدة.
deliveryVehicleId

string

رقم تعريف المركبة التي تؤدي هذه المهمة.
plannedLocation

object (LocationInfoLog)

الموقع الذي تكتمل فيه المهمة.
taskDuration

string (Duration format)

وقت إضافي لتنفيذ إجراء في هذا الموقع الجغرافي

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

object (TimeWindowLog)

الفترة الزمنية التي يجب أن تكتمل خلالها المهمة.
journeySharingInfo

object (JourneySharingInfoLog)

مشاركة بيانات حقول معيّنة
taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

تهيئة تتبع المهام التي تحدد عناصر البيانات التي تكون مرئية للمستخدمين النهائيين تحت أي ظروف.
attributes[]

object (TaskAttributeLog)

قائمة بسمات "Task" المخصّصة يجب أن يكون لكل سمة مفتاح فريد.

JourneySharingInfoLog

مشاركة بيانات حقول معيّنة

تمثيل JSON 
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
الحقول
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

معلومات التتبع لكل محطة ستنتقل إليها المركبة المخصصة قبل إكمال هذه المهمة. قد تحتوي هذه القائمة على نقاط توقف من مهام أخرى.
lastLocation

object (DeliveryVehicleLocationLog)

آخر موقع جغرافي تم الإبلاغ عنه للمركبة
lastLocationSnappable

boolean

تشير هذه السمة إلى ما إذا كان من الممكن تثبيت lastLocation في المركبة على currentRouteSegment. False في حال عدم توفّر lastLocation أو currentRouteSegment.

TaskTrackingViewConfigLog

هي رسالة الضبط التي تحدِّد متى يجب أن يظهر عنصر البيانات للمهمة للمستخدمين النهائيين.

تمثيل JSON 
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
الحقول
routePolylinePointsVisibility

object (VisibilityOptionLog)

الحقل الذي يحدد متى يمكن أن تكون النقاط المتعددة الخطوط للمسار مرئية. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

الحقل الذي يحدّد الوقت المقدّر للوصول مرئيًا. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

الحقل الذي يحدد الوقت المقدّر لإكمال المهمة في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

الحقل الذي يحدد متى يمكن إظهار المسافة المتبقية بالسيارة. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
remainingStopCountVisibility

object (VisibilityOptionLog)

الحقل الذي يحدد عدد مرات التوقّف المتبقية ويظهر فيه. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
vehicleLocationVisibility

object (VisibilityOptionLog)

الحقل الذي يحدّد الحالات التي يمكن فيها رؤية الموقع الجغرافي للمركبة في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.

VisibilityOptionLog

رسالة الخيار التي تحدِّد متى يجب أن يكون عنصر البيانات مرئيًا للمستخدمين النهائيين.

تمثيل JSON 
{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}
الحقول

حقل الاتحاد visibility_option.

يمكن أن يكون visibility_option واحدًا فقط مما يلي:
remainingStopCountThreshold

integer

يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كان عدد مرات التوقف المتبقي <= leftStopCountThreshold.
durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

يكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كان الوقت المقدّر للوصول إلى المحطة <= durationUntilestimateArrivalTimeThreshold.

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

integer

يكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كانت المسافة المتبقية في السيارة بالأمتار <= سماعة وحدات المسافة المتبقية في القيادة - Threshold.
always

boolean

في حال ضبط عنصر البيانات هذا على "صحيح"، سيظهر دائمًا للمستخدمين النهائيين بدون حدود.
never

boolean

إذا تم ضبط هذه السياسة على "صحيح"، يتم دائمًا إخفاء عنصر البيانات هذا عن المستخدمين النهائيين بدون أي حدود.

TaskAttributeLog

تصف سمة المهمة كزوج المفتاح/القيمة. "key:value" لا يمكن أن يتجاوز طول السلسلة 256 حرفًا.

تمثيل JSON 
{
  "key": string,

  // Union field task_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field task_attribute_value.
}
الحقول
key

string

مفتاح السمة. لا يجوز أن تحتوي المفاتيح على علامة النقطتين (:).
حقل الاتحاد task_attribute_value. قيمة السمة، يمكن أن تكون في سلسلة أو قيمة منطقية أو نوع مزدوج. إذا لم يتم ضبط أي سمة، سيتم تخزين قيمة TaskAttribute string_value كسلسلة فارغة "". يمكن أن يكون task_attribute_value واحدًا فقط مما يلي:
stringValue

string

قيمة السمة المكتوبة بالسلسلة
boolValue

boolean

قيمة السمة المكتوبة بطريقة منطقية
numberValue

number

قيمة سمة من نوعين