TaskLog

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)

진행을 나타내는 Task의 상태입니다.

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)

커스텀 Task 속성 목록입니다. 각 속성에는 고유한 키가 있어야 합니다.

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)

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

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

remainingDrivingDistanceMetersThreshold

integer

이 데이터 요소는 남은 운전 거리(미터)가 <= leftDriverDistanceMetersThreshold일 때 최종 사용자에게 표시됩니다.

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

string

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

boolValue

boolean

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

numberValue

number

이중 유형 속성 값입니다.