TaskLog

El registro de un recurso de 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 con el formato providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

El tipo de tarea.

state

enum (TaskStateLog)

El estado de una tarea que indica su progreso.

taskOutcome

enum (TaskOutcomeLog)

El resultado de intentar ejecutar una tarea. Cuando TaskState se cierra, 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 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)

Es la ubicación donde 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 el cliente a fin de evitar una asignación innecesaria o complicada.

deliveryVehicleId

string

El ID del vehículo que realiza esta tarea.

plannedLocation

object (LocationInfoLog)

Es la ubicación en la que se completa la tarea.

taskDuration

string (Duration format)

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

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

targetTimeWindow

object (TimeWindowLog)

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

journeySharingInfo

object (JourneySharingInfoLog)

Recorrido que comparte 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 personalizados de Task. Cada atributo debe tener una clave única.

JourneySharingInfoLog

Recorrido que comparte campos específicos

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

object (VehicleJourneySegmentLog)

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

lastLocation

object (DeliveryVehicleLocationLog)

Es la última ubicación informada del vehículo.

lastLocationSnappable

boolean

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

TaskTrackingViewConfigLog

El mensaje de configuración que define cuándo los usuarios finales deben poder ver un elemento de datos de una Task.

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)

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

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

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

estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

El campo que especifica cuándo se puede ver 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 de proyecto para estos datos.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

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

remainingStopCountVisibility

object (VisibilityOptionLog)

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

vehicleLocationVisibility

object (VisibilityOptionLog)

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

VisibilityOptionLog

Es el mensaje de opción que define cuándo se debe mostrar un elemento de datos a 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 inferior a remanenteStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

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

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Este elemento de datos es visible para los usuarios finales si la distancia restante en automóvil en metros es igual o inferior a la cantidad de metros que le siguen.

always

boolean

Si se configura como verdadero, este elemento de datos siempre es 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 longitud de la string "key:value" 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 ser de tipo string, bool o doble. Si no se establece ninguno, el valor string_value de TaskAttribute se almacenará como la string vacía "". task_attribute_value solo puede ser una de las siguientes opciones:
stringValue

string

Valor del atributo escrito en cadena.

boolValue

boolean

Valor de atributo de tipo booleano.

numberValue

number

Valor de atributo de doble tipo.