Xoá xe giao hàng

Tài liệu này mô tả cách xoá xe giao hàng. Giả sử bạn đã thiết lập Công cụ của đội xe. Xem bài viết Thiết lập Công cụ quản lý đội xe.

Thông tin cơ bản về việc xoá xe giao hàng

Hệ thống của bạn có thể sử dụng Công cụ quản lý đội xe để xoá xe tải giao hàng trong các trường hợp sau:

  • Để thực hiện các thao tác dọn dẹp trong khi kiểm thử API Động cơ của đội xe.
  • Để xoá ngay một Xe giao hàng không còn cần thiết.

Để xoá xe tải giao hàng, hãy gửi yêu cầu bằng gRPC hoặc REST.

  • Phương thức DeleteDeliveryVehicle(): gRPC hoặc REST
  • Thông báo DeleteDeliveryVehicleRequest: chỉ gRPC

Sử dụng thông tin xác thực thích hợp cho tài khoản dịch vụ của dự án như mô tả trong phần Công cụ của đội xe: Vai trò của tài khoản dịch vụ.

Ví dụ: xoá xe tải

Java

Ví dụ sau đây cho biết cách sử dụng thư viện gRPC Java để xoá xe tải.

  static final String PROJECT_ID = "my-rideshare-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  String deliveryVehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;

  DeliveryServiceBlockingStub deliveryService = DeliveryServiceGrpc.newBlockingStub(channel);

  // Delete Vehicle request
  DeleteDeliveryVehicleRequest deleteDeliveryVehicleRequest =
      DeleteDeliveryVehicleRequest.newBuilder().setName(deliveryVehicleName).build();

  try {
    deliveryService.deleteDeliveryVehicle(deleteDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:            // The delivery vehicle doesn't exist.
         break;
       case FAILED_PRECONDITION:  // There are tasks(s) that reference delivery vehicle.
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

Ví dụ sau đây cho thấy cách xoá xe tải hàng hoá khỏi Công cụ xe bằng cách sử dụng REST bằng cách gọi DeleteDeliveryVehicle.

  # DELETE https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<vehicleId>
  # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
  curl -X DELETE -H "Authorization: Bearer ${JWT}" \
    "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryvehicles/${VEHICLE_ID}"

Nếu thao tác xoá thành công, API sẽ trả về một phản hồi trống.

Xử lý lỗi

Khi xoá một xe giao hàng, bạn có thể gặp lỗi FAILED_PRECONDITION. Trong trường hợp này, có(các) tác vụ tham chiếu đến xe giao hàng. Cách tiếp tục xoá:

  1. Gọi ListTasks để tìm(các) tác vụ tham chiếu đến Xe giao hàng.
  2. Gọi DeleteTask để xoá từng việc cần làm đã tìm thấy.

Bước tiếp theo