البحث عن مهام

يوضّح هذا المستند الطرق التي يمكنك من خلالها العثور على معلومات المهام من خادم أو متصفّح. تتيح Fleet Engine طريقتَين للعثور على المهام:

• البحث عن المهام: يمكنك البحث عن المهام باستخدام المعرّفات التالية:

  • معرّف المهمة: يستخدمه المستخدمون، مثل مشغّلي أساطيل المركبات، الذين يمكنهم الوصول إلى العرض الكامل لبيانات المهمة.
  • معرّف التتبُّع: تستخدمه برامج العميل لتقديم معلومات محدودة إلى المستخدم النهائي، مثل الوقت المتوقّع لوصول طرد إلى منزله.

  احرص على فهم الفرق بين معرّف المهمة ومعرّف تتبُّع المهمة. ولكنهما مختلفان. راجِع حقول المهام الأساسية في دليل المهام المجدوَلة.

• عرض المهام: إذن وصول واسع النطاق إلى المهام، مخصّص للمستخدمين الموثوق بهم فقط

البحث عن المهام

يوضّح هذا القسم كيفية البحث عن المهام باستخدام رقم تعريف المهمة أو رقم تعريف التتبُّع. ويجب استيفاء المتطلبات التالية:

• يجب أن تلتزم عمليات البحث حسب رقم التعريف التتبُّعي بقواعد مستوى الظهور الموضّحة في قواعد مستوى الظهور للكائنات التي يتم تتبُّعها.

• استخدِم الرمز المميز الأضيق نطاقًا قدر الإمكان للحدّ من المخاطر الأمنية. على سبيل المثال، إذا كنت تستخدم رمزًا مميزًا خاصًا بمستهلك خدمة التوصيل، ستعرض أي طلبات معلومات ذات صلة بالمستخدم النهائي فقط، مثل المرسل أو المستلم للشحنة. تحذف Fleet Engine جميع المعلومات الأخرى في الردود. لمزيد من المعلومات حول الرموز المميزة، يُرجى الاطّلاع على رموز JSON المميزة للويب.

البحث عن مهمة حسب معرّف المهمة

يمكنك البحث عن مهمة باستخدام رقم تعريفها من بيئة خادم باستخدام gRPC أو REST. توضّح الأمثلة التالية كيفية استخدام مكتبة Java gRPC أو طلب REST إلى GetTask.

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

البحث عن المهام حسب رقم تعريف التتبُّع

توضِّح الأمثلة التالية كيفية البحث عن المهام حسب رقم تعريف تتبُّع الشحنة باستخدام gRPC أو طلب HTTP REST إلى GetTaskTrackingInfo.

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

عرض المهام

تتطلّب إضافة المهام إلى القائمة إذن وصول واسع النطاق إلى المهام. إنّ عرض المهام مخصّص للمستخدمين الموثوق بهم فقط. استخدِم رموز المصادقة الخاصة بدور "قارئ أسطول التوصيل" أو "مشرف التوصيل" عند تقديم طلبات مهام القائمة. يُرجى الاطّلاع على أدوار حساب الخدمة للحصول على مزيد من المعلومات.

تقسيم القوائم إلى صفحات

يتم تقسيم قوائم المهام إلى صفحات. يمكن تحديد حجم الصفحة في طلبات عرض المهام في قائمة. في حال تحديد حجم الصفحة، لن يتجاوز عدد المهام المعروضة حجم الصفحة المحدّد. في حال عدم توفّر حجم الصفحة، يتم استخدام قيمة تلقائية معقولة. إذا تجاوز حجم الصفحة المطلوب الحدّ الأقصى الداخلي، سيتم استخدام الحدّ الأقصى الداخلي.

يمكن أن تتضمّن قائمة المهام رمزًا مميزًا لقراءة الصفحة التالية من النتائج. لاسترداد الصفحة التالية، أعِد إصدار الطلب نفسه مع الرمز المميّز للصفحة. عندما يكون الرمز المميّز للصفحة الذي تم عرضه فارغًا، لن تتوفّر أي مهام أخرى يمكن استرجاعها.

الحقول عند إدراج المهام

تخفي Fleet Engine الحقول التالية عند إدراج المهام:

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

استخدِم تنسيقات الحقول التالية استنادًا إلى "اقتراحات تحسين واجهات برمجة التطبيقات من Google":

فلترة المهام المُدرَجة

يمكنك فلترة المهام المُدرَجة حسب معظم خصائص المهام. للاطّلاع على بنية طلب البحث في الفلتر، يُرجى الرجوع إلى AIP-160. في حال عدم تحديد طلب بحث للفلترة، سيتم إدراج جميع المهام.

يعرض الجدول التالي خصائص المهام الصالحة التي يمكنك استخدامها للفلترة:

يمكنك الاطّلاع على AIP-160 للحصول على قائمة كاملة بعوامل تشغيل طلبات البحث عن الفلاتر.

أمثلة على مهام القائمة

يوضّح المثال التالي كيفية إدراج المهام لـ deliveryVehicleId وسمة مهمة، وذلك باستخدام مكتبة Java gRPC وباستخدام طلب HTTP REST إلى ListTasks.

يمكن أن يظل الردّ الناجح فارغًا. يشير الردّ الفارغ إلى عدم توفّر أي مهام مرتبطة بـ deliveryVehicleId المقدَّم.

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

الخطوات التالية

• إدارة الشحنات