TaskLog

Nhật ký của tài nguyên Việc cần làm trong API Phân phối.

Biểu diễn dưới dạng 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)
    }
  ]
}
Trường
name

string

Tên tài nguyên tác vụ ở định dạng providers/{providerId}/tasks/{taskId}.
type

enum (TaskTypeLog)

Loại tác vụ.
state

enum (TaskStateLog)

Trạng thái của một Việc cần làm cho biết tiến trình của việc đó.
taskOutcome

enum (TaskOutcomeLog)

Kết quả của việc cố gắng thực thi một tác vụ. Khi TaskState đóng, điều này cho biết liệu TaskState đã hoàn tất thành công hay chưa.
taskOutcomeTime

string (Timestamp format)

Dấu thời gian của thời điểm đặt kết quả của tác vụ (từ nhà cung cấp).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
taskOutcomeLocation

object (LocationInfoLog)

Vị trí đặt kết quả của tác vụ.
taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Cho biết giá trị của taskOutcomeLocation đến từ đâu.
trackingId

string

Trường này hỗ trợ việc lưu trữ mã nhận dạng cho khách hàng để tránh việc liên kết không cần thiết hoặc phức tạp.
deliveryVehicleId

string

Mã của xe thực hiện Việc cần làm này.
plannedLocation

object (LocationInfoLog)

Vị trí hoàn thành việc cần làm.
taskDuration

string (Duration format)

Thời gian bổ sung để thực hiện một hành động tại vị trí này.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
targetTimeWindow

object (TimeWindowLog)

Khoảng thời gian cần hoàn thành tác vụ.
journeySharingInfo

object (JourneySharingInfoLog)

Các trường cụ thể khi chia sẻ hành trình.
taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

Cấu hình theo dõi tác vụ chỉ định những phần tử dữ liệu mà người dùng cuối có thể nhìn thấy trong những trường hợp nào.
attributes[]

object (TaskAttributeLog)

Danh sách các thuộc tính Tuỳ chỉnh của Tác vụ. Mỗi thuộc tính phải có một khoá riêng biệt.

JourneySharingInfoLog

Các trường cụ thể khi chia sẻ hành trình.

Biểu diễn dưới dạng JSON 
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
Trường
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

Thông tin theo dõi cho mỗi điểm dừng mà xe được chỉ định sẽ đi đến trước khi hoàn tất nhiệm vụ này. Danh sách này có thể chứa các điểm dừng của các việc cần làm khác.
lastLocation

object (DeliveryVehicleLocationLog)

Vị trí gần đây nhất được báo cáo của xe.
lastLocationSnappable

boolean

Cho biết liệu có thể chụp nhanh lastLocation của xe vào currentRouteSegment hay không. False nếu lastLocation hoặc currentRouteSegment không tồn tại.

TaskTrackingViewConfigLog

Thông báo cấu hình xác định thời điểm người dùng cuối nhìn thấy một phần tử dữ liệu của một Tác vụ.

Biểu diễn dưới dạng JSON 
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
Trường
routePolylinePointsVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm các điểm của đường đa tuyến của tuyến đường có thể hiển thị. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị thời gian đến dự kiến. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị thời gian hoàn thành công việc ước tính. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị quãng đường lái xe còn lại. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
remainingStopCountVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị số lượng điểm dừng còn lại. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
vehicleLocationVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị vị trí của xe. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.

VisibilityOptionLog

Thông báo tuỳ chọn xác định thời điểm người dùng cuối nhìn thấy một phần tử dữ liệu.

Biểu diễn dưới dạng 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.
}
Trường

Trường hợp hợp nhất visibility_option.

visibility_option chỉ có thể là một trong những loại sau:
remainingStopCountThreshold

integer

Người dùng cuối có thể thấy phần tử dữ liệu này nếu số lượng điểm dừng còn lại <= remainingStopCountThreshold.
durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Người dùng cuối sẽ nhìn thấy phần tử dữ liệu này nếu ETA đến điểm dừng <= durationUntilEstimatedArrivalTimeThreshold.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
remainingDrivingDistanceMetersThreshold

integer

Người dùng cuối có thể thấy phần tử dữ liệu này nếu quãng đường lái xe còn lại tính bằng mét <= remainingDrivingDistanceMetersThreshold.
always

boolean

Nếu bạn đặt thành đúng, người dùng cuối sẽ luôn thấy phần tử dữ liệu này mà không có ngưỡng nào.
never

boolean

Nếu bạn đặt thành đúng, thì phần tử dữ liệu này sẽ luôn bị ẩn khỏi người dùng cuối mà không có ngưỡng nào.

TaskAttributeLog

Mô tả thuộc tính công việc dưới dạng cặp khoá-giá trị. Chiều dài chuỗi "khoá:giá trị" không được vượt quá 256 ký tự.

Biểu diễn dưới dạng 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.
}
Trường
key

string

Khoá của thuộc tính. Khoá không được chứa ký tự dấu hai chấm (:).
Trường hợp hợp nhất task_attribute_value. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc double. Nếu không đặt giá trị nào, string_value của TaskAttribute sẽ được lưu trữ dưới dạng chuỗi trống "". task_attribute_value chỉ có thể là một trong những giá trị sau:
stringValue

string

Giá trị thuộc tính được nhập dưới dạng chuỗi.
boolValue

boolean

Giá trị thuộc tính được nhập bằng boolean.
numberValue

number

Giá trị thuộc tính được nhập hai lần.