TaskLog

Deliveries API의 Task 리소스에 대한 로그입니다.

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 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

taskOutcomeLocation

object (LocationInfoLog)

작업 결과가 설정된 위치입니다.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

taskOutcomeLocation 값의 출처를 나타냅니다.

trackingId

string

이 필드를 사용하면 고객이 불필요하거나 복잡한 매핑을 피할 수 있도록 ID를 쉽게 저장할 수 있습니다.

deliveryVehicleId

string

이 작업을 수행하는 차량의 ID입니다.

plannedLocation

object (LocationInfoLog)

작업이 완료되는 위치입니다.

taskDuration

string (Duration format)

이 위치에서 작업을 수행하기 위한 추가 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

targetTimeWindow

object (TimeWindowLog)

작업을 완료해야 하는 기간입니다.

journeySharingInfo

object (JourneySharingInfoLog)

특정 필드를 공유하는 여정

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

특정 상황에서 최종 사용자에게 표시되는 데이터 요소를 지정하는 작업 추적 구성입니다.

attributes[]

object (TaskAttributeLog)

사용자 지정 작업 속성의 목록입니다. 각 속성에는 고유 키가 있어야 합니다.

JourneySharingInfoLog

특정 필드를 공유하는 여정

JSON 표현
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
필드
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

이 작업을 완료하기 전에 할당된 차량이 이동할 각 정류장에 대한 추적 정보입니다. 이 목록에는 다른 작업의 중지가 포함될 수 있습니다.

lastLocation

object (DeliveryVehicleLocationLog)

차량의 마지막으로 보고된 위치입니다.

lastLocationSnappable

boolean

차량의 lastLocationcurrentRouteSegment에 스냅할 수 있는지를 나타냅니다. lastLocation 또는 currentRouteSegment가 없으면 False입니다.

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)

이 데이터 요소는 정류장 도착예정시간이 <= durationUntilexpectedArrivalTimeThreshold 이상인 경우 최종 사용자에게 표시됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

remainingDrivingDistanceMetersThreshold

integer

이 데이터 요소는 남은 운전 거리(미터 단위)가 <= leftDrivingDistanceMetersThreshold 미만인 경우 최종 사용자에게 표시됩니다.

always

boolean

true로 설정하면 데이터 요소가 기준점 없이 최종 사용자에게 항상 표시됩니다.

never

boolean

true로 설정되면 이 데이터 요소는 기준점 없이 최종 사용자에게 항상 숨겨집니다.

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. 속성 값은 문자열, 부울 또는 double 형식일 수 있습니다. 아무것도 설정되지 않은 경우 TaskAttribute string_value는 빈 문자열 ""로 저장됩니다. task_attribute_value는 다음 중 하나여야 합니다.
stringValue

string

문자열 유형의 속성 값입니다.

boolValue

boolean

부울 유형의 속성 값입니다.

numberValue

number

이중 유형의 속성 값입니다.