Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Encontrar tarefas

Este documento descreve as maneiras de encontrar informações de tarefas em um servidor ou navegador. O Fleet Engine oferece duas maneiras de encontrar tarefas:

Pesquisar tarefas: é possível pesquisar tarefas pelos seguintes IDs:
- ID da tarefa: usado por usuários como operadores de frota que têm acesso à visualização completa dos dados da tarefa.
- ID de acompanhamento: usado pelo software cliente para fornecer informações limitadas a um usuário final, como quando um pacote é esperado na casa dele.
Entenda a diferença entre o ID da tarefa e o ID de acompanhamento da tarefa. Eles não são a mesma coisa. Consulte Campos básicos de tarefas no guia de tarefas programadas.
Listar tarefas: um acesso amplo a tarefas, destinado apenas a usuários confiáveis.

Pesquisar tarefas

Esta seção descreve como pesquisar tarefas por ID ou ID de rastreamento. Ela tem os seguintes requisitos:

As pesquisas por ID de rastreamento precisam obedecer às regras de visibilidade declaradas em Regras de visibilidade para objetos rastreados.
Use o token mais restrito possível para limitar os riscos de segurança. Por exemplo, se você usar um token de consumidor de entrega, todas as chamadas vão retornar apenas informações relevantes para esse usuário final, como o remetente ou o destinatário de uma remessa. O Fleet Engine oculta todas as outras informações nas respostas. Para mais informações sobre tokens, consulte Tokens JSON da Web.

Pesquisar tarefa por ID

É possível pesquisar uma tarefa pelo ID dela em um ambiente de servidor usando gRPC ou REST. Os exemplos a seguir mostram como usar a biblioteca gRPC Java ou uma solicitação REST para GetTask.

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8597549";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task request
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 GetTaskRequest getTaskRequest = GetTaskRequest.newBuilder()  // No need for the header
     .setName(taskName)
     .build();

 try {
   Task task = deliveryService.getTask(getTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

GET https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<taskId>

<id> é um identificador exclusivo da tarefa.
<taskId> é o ID da tarefa a ser pesquisada.
O cabeçalho da solicitação precisa conter um campo Authorization com o valor Bearer <token>, em que <token> é emitido pelo servidor de acordo com as diretrizes descritas em Papéis da conta de serviço e tokens JSON da Web.
O corpo da solicitação precisa estar vazio.
Se a pesquisa for bem-sucedida, o corpo da resposta vai conter uma entidade de tarefa.

Exemplo de comando curl:

    # Set JWT, PROJECT_ID, and TASK_ID in the local environment
    curl -H "Authorization: Bearer ${JWT}" \
      "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}"

Pesquisar tarefas por ID de rastreamento

Os exemplos a seguir mostram como pesquisar tarefas pelo ID de acompanhamento de remessa usando gRPC ou uma chamada HTTP REST para GetTaskTrackingInfo.

gRPC

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TRACKING_ID = "TID-7449w087464x5";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
GetTaskTrackingInfoRequest getTaskTrackingInfoRequest = GetTaskTrackingInfoRequest.newBuilder()  // No need for the header
    .setParent(parent)
    .setTrackingId(TRACKING_ID)
    .build();

try {
  TaskTrackingInfo taskTrackingInfo = deliveryService.getTaskTrackingInfo(getTaskTrackingInfoRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

GET https://fleetengine.googleapis.com/v1/providers/<project_id>/taskTrackingInfo/<tracking_id>

<tracking_id> é o ID de rastreamento associado à tarefa.
O cabeçalho da solicitação precisa conter um campo Authorization com o valor Bearer <token>, em que <token> tem o papel correto da conta de serviço. Consulte Papéis da conta de serviço.
Se a pesquisa for bem-sucedida, o corpo da resposta vai conter uma taskTrackingInfo entidade.

Exemplo de comando curl:

# Set JWT, PROJECT_ID, and TRACKING_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/taskTrackingInfo/${TRACKING_ID}"

Listar tarefas

As solicitações de listagem de tarefas oferecem acesso amplo a elas. A listagem de tarefas é destinada apenas a usuários confiáveis. Use tokens de autenticação do leitor de frota de entrega ou do administrador de entrega ao fazer solicitações de listagem de tarefas. Consulte Papéis da conta de serviço para mais informações.

Listas de paginação

As listas de tarefas são paginadas. Um tamanho de página pode ser especificado nas solicitações de listagem de tarefas. Se um tamanho de página for especificado, o número de tarefas retornadas não será maior que o tamanho de página especificado. Se nenhum tamanho de página estiver presente, um padrão razoável será usado. Se o tamanho da página solicitada exceder um valor máximo interno, o máximo interno será usado.

Uma lista de tarefas pode incluir um token para ler a próxima página de resultados. Para recuperar a próxima página, reemita a mesma solicitação com o token de página. Quando o token de página retornado estiver vazio, não haverá mais tarefas disponíveis para recuperação.

Campos ao listar tarefas

O Fleet Engine oculta os seguintes campos ao listar tarefas:

VehicleStop.planned_location
VehicleStop.state
VehicleStop.TaskInfo.taskId

Use os seguintes formatos de campo com base nas propostas de melhoria da API do Google:

Tipo de campo	Formato	Exemplo
Carimbo de data/hora	RFC-3339	`task_outcome_time = 2022-03-01T11:30:00-08:00`
Duração	Número de segundos seguido por um `s`	`task_duration = 120s`
Enumeração	String	`state = CLOSED AND type = PICKUP`
Local	`point.latitude` e `point.longitude`	`planned_location.point.latitude > 36.1 AND planned_location.point.longitude < -122.0`

Filtrar tarefas listadas

É possível filtrar as tarefas listadas pela maioria das propriedades delas. Para a sintaxe de consulta de filtro, consulte AIP-160. Se nenhuma consulta de filtro for especificada, todas as tarefas serão listadas.

A tabela a seguir mostra as propriedades de tarefas válidas que podem ser usadas para filtragem:

Propriedades de tarefas para listas de filtragem
`type` `attributes` `tracking_id` `delivery_vehicle_id` `state` `planned_location`	`task_duration` `task_duration_outcome` `task_outcome` `task_outcome_location` `task_outcome_time`

Consulte AIP-160 para uma lista completa de operadores de consulta de filtro.

Exemplos de tarefas de lista

O exemplo a seguir mostra como listar tarefas para um deliveryVehicleId e um atributo de tarefa, ambos com a biblioteca gRPC Java e com a chamada HTTP REST para ListTasks.

Uma resposta bem-sucedida ainda pode estar vazia. Uma resposta vazia indica que não há tarefas associadas ao deliveryVehicleId fornecido.

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TRACKING_ID = "TID-7449w087464x5";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Tasks request
 String parent = "providers/" + PROJECT_ID;
 ListTasksRequest listTasksRequest = ListTasksRequest.newBuilder()  // No need for the header
     .setParent(parent)
     .setFilter("delivery_vehicle_id = 123 AND attributes.foo = true")
     .build();

 try {
   ListTasksResponse listTasksResponse = deliveryService.listTasks(listTasksRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

GET https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks

Para aplicar um filtro às tarefas listadas, inclua um parâmetro de URL "filter" com uma consulta de filtro com escape de URL como valor.

O cabeçalho da solicitação precisa conter um campo Authorization com o valor Bearer <token>, em que <token> tem o papel correto da conta de serviço. Consulte Papéis da conta de serviço.

Uma pesquisa bem-sucedida fornece um corpo de resposta com a seguinte estrutura:

    // JSON representation
    {
      "tasks": [
        {
          object (Task)
        }
      ],
      "nextPageToken": string,
      "totalSize": integer
    }

Exemplo de comando curl:

 # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
 curl -H "Authorization: Bearer ${JWT}" \
   "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?filter=state%20%3D%20OPEN%20AND%20delivery_vehicle_id%20%3D%20${VEHICLE_ID}"

A seguir

Gerenciar remessas

Encontrar tarefas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Pesquisar tarefas

Pesquisar tarefa por ID

gRPC

REST

Pesquisar tarefas por ID de rastreamento

gRPC

REST

Listar tarefas

Listas de paginação

Campos ao listar tarefas

Filtrar tarefas listadas

Exemplos de tarefas de lista

gRPC

REST

A seguir

Encontrar tarefas