TaskLog

Nhật ký của tài nguyên Tác vụ trong Deliveries API.

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)
    }
  ]
}
Các trường
name

string

Tên tài nguyên công việc ở đị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 Nhiệm vụ cho biết tiến trình của Nhiệm vụ.
taskOutcome

enum (TaskOutcomeLog)

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

string (Timestamp format)

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
taskOutcomeLocation

object (LocationInfoLog)

Vị trí nơi đặt kết quả của nhiệm vụ.
taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

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

string

Trường này hỗ trợ lưu trữ ID cho khách hàng để tránh ánh xạ không cần thiết hoặc phức tạp.
deliveryVehicleId

string

Mã của xe thực hiện Nhiệm vụ này.
plannedLocation

object (LocationInfoLog)

Vị trí nơi việc cần làm được hoàn thành.
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ố phân số, kết thúc bằng 's'. Ví dụ: "3.5s".
targetTimeWindow

object (TimeWindowLog)

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

object (JourneySharingInfoLog)

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

object (TaskTrackingViewConfigLog)

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

object (TaskAttributeLog)

Danh sách thuộc tính tuỳ chỉnh của Công việc. Mỗi thuộc tính phải có một khoá duy nhất.

JourneySharingInfoLog

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

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

object (VehicleJourneySegmentLog)

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

object (DeliveryVehicleLocationLog)

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

boolean

Cho biết liệu lastLocation của xe có thể gắn 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 nên nhìn thấy phần tử dữ liệu của một Công việc.

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)
  }
}
Các trường
routePolylinePointsVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị các điểm nhiều đường thẳng. 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 gian đến dự kiến 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.
estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm hoàn thành tác vụ ước tính 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.
remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể nhìn thấy 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 nên 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.
}
Các trường

Trường nhóm visibility_option.

visibility_option chỉ có thể là một trong những trạng thái sau đây:
remainingStopCountThreshold

integer

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

string (Duration format)

Người dùng cuối có thể thấy thành phần dữ liệu này nếu thời gian dự kiến đến điểm dừng <= durationuntilEstimated gặpTimeThreshold.

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

integer

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

boolean

Nếu bạn đặt chính sách này thành true, thì người dùng cuối sẽ luôn nhì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 chính sách này thành true (đúng), thì phần tử dữ liệu này sẽ luôn ẩn đối với người dùng cuối mà không có ngưỡng nào.

TaskAttributeLog

Mô tả thuộc tính của công việc dưới dạng một cặp khoá-giá trị. Độ dài chuỗi "key:value" 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.
}
Các 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 nhóm task_attribute_value. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc kiểu double. Nếu bạn không đặt giá trị, chuỗi_value sẽ được lưu trữ dưới dạng chuỗi trống "". task_attribute_value có thể chỉ là một trong các giá trị sau:
stringValue

string

Giá trị thuộc tính đã nhập chuỗi.
boolValue

boolean

Giá trị thuộc tính đã nhập là Boolean.
numberValue

number

Giá trị thuộc tính đã nhập 2 lần.