Görevleri bulma

Bu dokümanda, bir emin olmanız gerekir. Fleet Engine, görevleri bulmanın iki yolunu destekler:

• Görevleri arama: Görevleri aşağıdaki kimliklere göre arayabilirsiniz:

  • Görev kimliği: Görev verilerinin tam görünümüne erişimi olan filo operatörleri gibi kullanıcılar tarafından kullanılır.
  • Takip kimliği: Son kullanıcıya sınırlı bilgi (ör. evine ne zaman kargo geleceği) sağlamak için istemci yazılımınız tarafından kullanılır.

  Görev kimliği ile görev arasındaki farkı anladığınızdan emin olun izleme kimliği. Ancak bunlar aynı değildir. Planlanmış görev kılavuzundaki Temel görev alanları bölümüne bakın.

• Görevleri listeleme: Yalnızca güvenilir kullanıcılara yönelik, görevlere geniş kapsamlı erişim.

Görev arama

Bu bölümde, görevleri görev kimliğine veya izleme kimliğine göre nasıl arayacağınız açıklanmaktadır. Aşağıdaki koşulları karşılamalıdır:

• İzleme kimliğine göre aramalar, görünürlük kurallarına uygun olmalıdır İzlenen nesneler için görünürlük kuralları bölümünde belirtildiği üzere.

• Güvenlik risklerini sınırlamak için mümkün olan en dar jetonu kullanın. Örneğin, bir teslimat tüketicisi jetonu kullanıyorsanız tüm çağrılar yalnızca ilgili son kullanıcıyla alakalı bilgileri (ör. gönderen veya gönderimin alıcısı) döndürür. Fleet Engine, yanıtlardaki diğer tüm bilgileri çıkartır. Jetonlar hakkında daha fazla bilgi için JSON Web jetonları bölümüne bakın.

Görev kimliğine göre görev ara

Bir görevi görev kimliğine göre, gRPC veya yeni bir sunucu ortamından REST. Aşağıdaki örneklerde, Java gRPC kitaplığının veya GetTask için bir REST isteğinin nasıl kullanılacağı gösterilmektedir.

 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;
 }

    # 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}"

İzleme kimliğine göre görev ara

Aşağıdaki örneklerde, gRPC veya GetTaskTrackingInfo için bir HTTP REST çağrısı kullanılarak görevlerin gönderi takip kimliklerine göre nasıl aranacağı gösterilmektedir.

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;
}

# 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}"

Görevleri listeleyin

Görevleri listelemek, görevlere geniş kapsamlı erişim gerektirir. Görevleri listeleme yalnızca güvenilir kullanıcılara ulaşabilirsiniz. Liste görevleri isteği gönderirken Yayınlama Ağı Okuyucu veya Yayınlama Yöneticisi kimlik doğrulama jetonlarını kullanın. Daha fazla bilgi için Hizmet hesabı rolleri başlıklı makaleyi inceleyin.

Listeleri sayfalara ayırma

Görev listeleri sayfalara ayrılır. Liste görevleri isteklerinde sayfa boyutu belirtilebilir. Bir sayfa boyutu belirtilirse döndürülen görevlerin sayısı belirtilen sayfa boyutundan büyük olamaz. Sayfa boyutu yoksa makul bir varsayılan değer bu düzenlemelerin nedenlerinden biri. İstenen sayfa boyutu dahili bir maksimum değeri aşıyorsa dahili maksimum değer kullanılır.

Görev listesi, sonuçların bir sonraki sayfasını okumak için bir jeton içerebilir. Alıcı: aynı isteği sayfa jetonuyla birlikte yeniden gönderebilirsiniz. Döndürülen sayfa jetonu boş olduğunda içerir.

Görevleri listelerken kullanılacak alanlar

Fleet Engine, görevleri listelerken aşağıdaki alanları çıkarır:

• VehicleStop.planned_location
• VehicleStop.state
• VehicleStop.TaskInfo.taskId

Google API İyileştirme Teklifleri'ne dayalı olarak aşağıdaki alan biçimlerini kullanın:

Listelenen görevleri filtreleme

Listelenen görevleri çoğu görev özelliğine göre filtreleyebilirsiniz. Filtre sorgusu söz dizimi için AIP-160 başlıklı makaleyi inceleyin. Filtre sorgusu belirtilmezse tüm görevler listelenir.

Aşağıdaki tabloda, filtreleme için kullanabileceğiniz geçerli görev özellikleri gösterilmektedir:

Filtre sorgu operatörlerinin tam listesi için AIP-160'a bakın.

Görev örneklerini listeleme

Aşağıdaki örnekte deliveryVehicleId ve görev özelliğiyle hem Java gRPC kitaplığı hem de ListTasks.

Başarılı bir yanıt yine de boş olabilir. Boş yanıt, hayır anlamına gelir görev, sağlanan deliveryVehicleId ile ilişkili.

 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;
 }

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

 # 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}"

Sırada ne var?

• Gönderimleri yönetme