TaskLog

Nhật ký của tài nguyên về Nhiệm vụ 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 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 thực hiện.

taskOutcome

enum (TaskOutcomeLog)

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

taskOutcomeTime

string (Timestamp format)

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

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

taskOutcomeLocation

object (LocationInfoLog)

Vị trí nơi kết quả của tác vụ đã được đặt.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Cho biết nguồn gốc của giá trị của taskOutcomeLocation.

trackingId

string

Trường này tạo điều kiện cho việc lưu trữ giấy tờ tuỳ thân 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 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êm thời gian để 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 với 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)

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

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

Cấu hình cho tính năng theo dõi công việc chỉ định những phần tử dữ liệu nào sẽ hiển thị cho người dùng cuối trong 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á duy nhất.

JourneySharingInfoLog

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

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

object (VehicleJourneySegmentLog)

Theo dõi thông tin về từng điểm dừng mà xe được chỉ định sẽ di chuyển đế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 từ các tác vụ khác.

lastLocation

object (DeliveryVehicleLocationLog)

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

lastLocationSnappable

boolean

Cho biết liệu lastLocation của xe có thể được 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 hiển thị một phần tử dữ liệu của Tác vụ đối với người dùng cuối.

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ó thể nhìn thấy các điểm nhiều đườ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 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 số lần dừng còn lại 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.

vehicleLocationVisibility

object (VisibilityOptionLog)

Trường chỉ định thời điểm có thể hiển thị thông tin 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 về lựa chọn xác định thời điểm hiển thị một phần tử dữ liệu cho người dùng cuối.

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 kết hợp 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 <=ThiếuStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Người dùng cuối có thể thấy phần tử dữ liệu này nếu thời gian đến dự kiến đến khi hết thời gian <= thời gian đến giá trị cũng được ước tính.

Thời lượng tính bằng giây với 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 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 <= preventdistanceMetersThreshold.

always

boolean

Nếu bạn đặt chính sách này thành true, thì phần tử dữ liệu này sẽ luôn hiển thị cho người dùng cuối mà không bị đặt ngưỡng.

never

boolean

Nếu bạn đặt chính sách này thành true, 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 đặt ngưỡng.

TaskAttributeLog

Mô tả thuộc tính công việc dưới dạng cặp khoá-giá trị. "key:value" độ dài chuỗi 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 kết hợp task_attribute_value. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc kiểu kép. Nếu bạn không đặt giá trị nào, thì TaskAttribute string_value 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 trạng thái sau đây:
stringValue

string

Giá trị thuộc tính đã nhập 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.