TaskLog

El registro de un recurso Task en la API de Deliveries.

Representación 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)
    }
  ]
}
Campos
name

string

El nombre del recurso de la tarea en formato de providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

El tipo de tarea.

state

enum (TaskStateLog)

El estado de una Task que indica su progresión.

taskOutcome

enum (TaskOutcomeLog)

El resultado de intentar ejecutar una tarea. Cuando se cierra TaskState, esto indica si se completó correctamente.

taskOutcomeTime

string (Timestamp format)

La marca de tiempo del momento en que se estableció el resultado de la tarea (desde el proveedor).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

taskOutcomeLocation

object (LocationInfoLog)

Ubicación en la que se estableció el resultado de la tarea.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Indica de dónde provino el valor de taskOutcomeLocation.

trackingId

string

Este campo facilita el almacenamiento de un ID para que el cliente evite una asignación innecesaria o complicada.

deliveryVehicleId

string

El ID del vehículo que realiza esta tarea.

plannedLocation

object (LocationInfoLog)

La ubicación donde se completa la tarea.

taskDuration

string (Duration format)

Tiempo adicional para realizar una acción en esta ubicación.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

targetTimeWindow

object (TimeWindowLog)

El período durante el cual se debe completar la tarea.

journeySharingInfo

object (JourneySharingInfoLog)

Recorrido en el que se comparten campos específicos.

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

Es la configuración del seguimiento de tareas que especifica qué elementos de datos son visibles para los usuarios finales en qué circunstancias.

attributes[]

object (TaskAttributeLog)

Una lista de atributos de Task personalizados. Cada atributo debe tener una clave única.

JourneySharingInfoLog

Recorrido en el que se comparten campos específicos.

Representación JSON
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
Campos
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

Información de seguimiento de cada parada a la que recorrerá el vehículo asignado antes de completar esta tarea. Esta lista puede contener paradas de otras tareas.

lastLocation

object (DeliveryVehicleLocationLog)

La última ubicación informada del vehículo.

lastLocationSnappable

boolean

Indica si el lastLocation del vehículo se puede ajustar al currentRouteSegment. False si lastLocation o currentRouteSegment no existen.

TaskTrackingViewConfigLog

Es el mensaje de configuración que define cuándo debe ser visible para los usuarios finales un elemento de datos de una tarea.

Representación JSON
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
Campos
routePolylinePointsVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo se pueden ver los puntos de polilínea de la ruta. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

El campo que especifica cuándo puede ser visible la hora de llegada estimada. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

El campo que especifica cuándo puede ser visible el tiempo estimado de finalización de la tarea. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

El campo que especifica cuándo se puede ver la distancia de conducción restante. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

remainingStopCountVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo se puede ver el recuento de paradas restantes. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

vehicleLocationVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo puede ser visible la ubicación del vehículo. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

VisibilityOptionLog

Es el mensaje de opción que define cuándo un elemento de datos debe ser visible para los usuarios finales.

Representación 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.
}
Campos

Campo de unión visibility_option.

visibility_option puede ser una de las siguientes opciones:

remainingStopCountThreshold

integer

Este elemento de datos es visible para los usuarios finales si el recuento de paradas restante es igual o igual que <= basedStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Este elemento de datos será visible para los usuarios finales si la hora de llegada estimada a la parada es <= durationUntilEstimatedArrivalTimeThreshold.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Este elemento de datos es visible para los usuarios finales si la distancia de conducción restante en metros es igual a <= pendingDistanceMetersThreshold.

always

boolean

Si se configura como verdadero, este elemento de datos siempre estará visible para los usuarios finales sin umbrales.

never

boolean

Si se configura como verdadero, este elemento de datos siempre está oculto para los usuarios finales sin umbrales.

TaskAttributeLog

Describe un atributo de tarea como un par clave-valor. La función “key:value” la longitud de la cadena no puede superar los 256 caracteres.

Representación 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.
}
Campos
key

string

La clave del atributo. Las claves no pueden contener el carácter de dos puntos (:).

Campo de unión task_attribute_value. El valor del atributo puede estar en cadena, en booleano o en tipo doble. Si no se establece ninguno, el string_value de TaskAttribute se almacenará como la cadena vacía "". task_attribute_value puede ser solo una de las siguientes opciones:
stringValue

string

Valor del atributo de tipo de cadena.

boolValue

boolean

Valor de atributo de tipo booleano.

numberValue

number

Valor de atributo de doble tipo.