يعرض هذا المستند كيفية إنشاء مجموعة من المهام من بيئة خادم. باستخدام gRPC أو REST. لمزيد من التفاصيل حول إنشاء المهام، يُرجى الاطّلاع على:
حقول المهام لإنشاء المهام بشكل مجمّع
عند إنشاء مهام بشكل مجمّع، يجب تضمين كل عنصر من عناصر "CreateTasksRequest
" في "requests
".
يجب أن تجتاز قواعد التحقّق نفسها التي يتم استخدامها في طلب CreateTask
لمهمة واحدة،
باستثناء الحقلَين parent
وheader
، يكون الحقلان اختياريًا.
في حال ضبطها، يجب أن تكون متطابقة مع الحقول المخصّصة لها في المستوى الأعلى.
BatchCreateTasksRequest
للمزيد من المعلومات، يمكنك الاطّلاع على المستندات المرجعية لواجهة برمجة التطبيقات في BatchCreateTasks
.
gRPC أو REST.
حقول مجمّعة مطلوبة
الحقل | القيمة |
---|---|
طلبات | Array<CreateTasksRequest> |
حقول المهام المجمّعة الاختيارية
الحقل | القيمة |
---|---|
header | DeliveryRequestHeader |
إنشاء مجموعة من المهام
توضِّح الأمثلة التالية كيفية إنشاء كلّ من مهمة استلام الطلب ومهمة تسليم.
باستخدام مكتبة Java gRPC أو كيفية تقديم طلب HTTP REST إلى
BatchCreateTask
عرض
عناصر JWT
لبناء جملة JWT الصحيحة.
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Delivery Task settings
Task deliveryTask = Task.newBuilder()
.setType(Task.Type.DELIVERY)
.setState(Task.State.OPEN)
.setTrackingId("delivery-tracking-id")
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.build();
// Delivery Task request
CreateTaskRequest createDeliveryTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header or parent fields
.setTaskId("task-8312508") // Task ID assigned by the Provider
.setTask(deliveryTask) // Initial state
.build();
// Pickup Task settings
Task pickupTask = Task.newBuilder()
.setType(Task.Type.PICKUP)
.setState(Task.State.OPEN)
.setTrackingId("pickup-tracking-id")
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.build();
// Pickup Task request
CreateTaskRequest createPickupTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header or parent fields
.setTaskId("task-8241890") // Task ID assigned by the Provider
.setTask(pickupTask) // Initial state
.build();
// Batch Create Tasks settings
String parent = "providers/" + PROJECT_ID;
// Batch Create Tasks request
BatchCreateTasksRequest batchCreateTasksRequest =
BatchCreateTasksRequest.newBuilder()
.setParent(parent)
.addRequests(createDeliveryTaskRequest)
.addRequests(createPickupTaskRequest)
.build();
// Error handling
// If Fleet Engine does not have any task(s) with these task ID(s) and the
// credentials of the requestor pass, the service creates the task(s)
// successfully.
try {
BatchCreateTasksResponse createdTasks = deliveryService.batchCreateTasks(
batchCreateTasksRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
راحة
لإنشاء مهمة تسليم واستلام من بيئة خادم، أنشِئ
استدعاء HTTP REST إلى BatchCreateTasks
:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/batchCreate
<id> هو معرّف فريد للمهمة.
يجب أن يحتوي عنوان الطلب على الحقل Authorize (تفويض) مع القيمة الحامل <token>، حيث يتم إصدار <token> من خلال الخادم وفقًا للإرشادات الموضحة في أدوار حساب الخدمة رموز JSON المميّزة للويب
يجب أن يحتوي نص الطلب على كيان BatchCreateTasksRequest
.
مثال على الطلب curl
:
# Set $JWT, $PROJECT_ID, $DELIVERY_TRACKING_ID, $DELIVERY_TASK_ID,
# $PICKUP_TRACKING_ID, and $PICKUP_TASK_ID in the local environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks:batchCreate" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"requests" : [
{
"taskId": "${DELIVERY_TASK_ID}",
"task" : {
"type": "DELIVERY",
"state": "OPEN",
"trackingId": "${DELIVERY_TRACKING_ID}",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "90s"
}
},
{
"taskId": "${PICKUP_TASK_ID}",
"task" : {
"type": "PICKUP",
"state": "OPEN",
"trackingId": "${PICKUP_TRACKING_ID}",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "90s"
}
}
]
}
EOM