مثال زیر نحوه استفاده از کتابخانه gRPC جاوا برای حذف وسیله نقلیه تحویل را نشان می دهد.
staticfinalStringPROJECT_ID="my-rideshare-co-gcp-project";staticfinalStringVEHICLE_ID="vehicle-8241890";StringdeliveryVehicleName="providers/"+PROJECT_ID+"/deliveryVehicles/"+VEHICLE_ID;DeliveryServiceBlockingStubdeliveryService=DeliveryServiceGrpc.newBlockingStub(channel);// Delete Vehicle requestDeleteDeliveryVehicleRequestdeleteDeliveryVehicleRequest=DeleteDeliveryVehicleRequest.newBuilder().setName(deliveryVehicleName).build();try{deliveryService.deleteDeliveryVehicle(deleteDeliveryVehicleRequest);}catch(StatusRuntimeExceptione){Statuss=e.getStatus();switch(s.getCode()){caseNOT_FOUND:// The delivery vehicle doesn't exist.break;caseFAILED_PRECONDITION:// There are tasks(s) that reference delivery vehicle.break;casePERMISSION_DENIED:break;}return;}
استراحت
مثال زیر نحوه حذف یک وسیله نقلیه تحویل از Fleet Engine را با استفاده از REST با برقراری تماس با DeleteDeliveryVehicle نشان می دهد.
# DELETE https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<vehicleId># Set JWT, PROJECT_ID, and VEHICLE_ID in the local environmentcurl-XDELETE-H"Authorization: Bearer ${JWT}"\"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryvehicles/${VEHICLE_ID}"
اگر عملیات حذف موفقیت آمیز باشد، API یک پاسخ خالی برمی گرداند.
رسیدگی به خطاها
هنگام حذف یک وسیله نقلیه تحویل، ممکن است با خطای FAILED_PRECONDITION مواجه شوید، در این صورت کار(هایی) وجود دارد که به وسیله نقلیه تحویل اشاره می کند. برای ادامه حذف:
با ListTasks تماس بگیرید تا کار(هایی) را پیدا کنید که به وسیله نقلیه تحویل اشاره می کنند.
با DeleteTask تماس بگیرید تا هر یک از وظایف پیدا شده را حذف کنید.
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Delete delivery vehicle\n\nThis document describes how to delete a delivery vehicle. It assumes you\nhave set up Fleet Engine. See [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n\nDelivery vehicle deletion basics\n--------------------------------\n\nYour system may use Fleet Engine to delete a delivery vehicle in the following situations:\n\n- To perform cleanup operations while testing Fleet Engine APIs.\n- To immediately delete a Delivery Vehicle that is no longer required.\n\nTo delete a delivery vehicle, send a request using either gRPC or REST.\n\n- `DeleteDeliveryVehicle()` method: [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#maps.fleetengine.delivery.v1.DeliveryService) or [REST](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.deliveryVehicles/delete)\n- `DeleteDeliveryVehicleRequest` message: [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#deletedeliveryvehiclerequest) only\n\nUse the appropriate credentials for the service account of your project as\ndescribed in [Fleet Engine: Service account roles](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/service-accounts).\n| **Note:** Fleet Engine automatically deletes a delivery vehicle after it has been inactive for a period of time. See [Vehicle re-use](/maps/documentation/mobility/fleet-engine/essentials/vehicles#vehicle_re-use).\n\nExample: delete delivery vehicle\n--------------------------------\n\n### Java\n\n\nThe following example shows how to use the [Java gRPC library](/maps/documentation/mobility/fleet-engine/essentials/client-libraries-tasks#java) to delete a\ndelivery vehicle. \n\n static final String PROJECT_ID = \"my-rideshare-co-gcp-project\";\n static final String VEHICLE_ID = \"vehicle-8241890\";\n\n String deliveryVehicleName = \"providers/\" + PROJECT_ID + \"/deliveryVehicles/\" + VEHICLE_ID;\n\n DeliveryServiceBlockingStub deliveryService = DeliveryServiceGrpc.newBlockingStub(channel);\n\n // Delete Vehicle request\n DeleteDeliveryVehicleRequest deleteDeliveryVehicleRequest =\n DeleteDeliveryVehicleRequest.newBuilder().setName(deliveryVehicleName).build();\n\n try {\n deliveryService.deleteDeliveryVehicle(deleteDeliveryVehicleRequest);\n } catch (StatusRuntimeException e) {\n Status s = e.getStatus();\n switch (s.getCode()) {\n case NOT_FOUND: // The delivery vehicle doesn't exist.\n break;\n case FAILED_PRECONDITION: // There are tasks(s) that reference delivery vehicle.\n break;\n case PERMISSION_DENIED:\n break;\n }\n return;\n }\n\n### REST\n\n\nThe following example shows how to delete a delivery vehicle from Fleet Engine using REST by\nmaking a call to `DeleteDeliveryVehicle`. \n\n # DELETE https://fleetengine.googleapis.com/v1/providers/\u003cproject_id\u003e/deliveryVehicles/\u003cvehicleId\u003e\n # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment\n curl -X DELETE -H \"Authorization: Bearer ${JWT}\" \\\n \"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryvehicles/${VEHICLE_ID}\"\n\nIf the delete operation is successful, the API returns an empty response.\n\nHandle errors\n-------------\n\nWhen deleting a delivery vehicle, you might encounter a `FAILED_PRECONDITION`\nerror, in which case there are task(s) that reference the delivery vehicle.\nTo proceed with the deletion:\n\n1. Call `ListTasks` to find task(s) that reference the Delivery Vehicle.\n2. Call `DeleteTask` to delete each of the found task.\n\n| **Warning:** Ensure that the found task(s) are no longer required. Once deleted, task(s) cannot be recovered.\n\nWhat's next\n-----------\n\n- [Create a scheduled journey](/maps/documentation/mobility/fleet-engine/journeys/tasks)"]]
