Trang này được dịch bởi Cloud Translation API.

Máy khách của API Đặt trước Java

Bạn có thể tải ứng dụng API cập nhật theo thời gian thực của Java xuống để bắt đầu triển khai bản cập nhật theo thời gian thực.

Điều kiện tiên quyết:

Đã tạo tài khoản dịch vụ, hãy tải khóa riêng tư của bạn xuống.

Bắt đầu:

Tải thư viện ứng dụng Java xuống để giải nén tệp để lấy gói "mapsbooking".
Tạo một dự án java trong IDE, tải các mã mẫu InventoryUpdate.java và BookingNotification.java xuống từ kho lưu trữ này:
```
git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
```
và nhập chúng vào dự án java của bạn trong thư mục src.
Sao chép khóa riêng tư của bạn (tệp JSON) vào thư mục src.
Thêm Thư viện ứng dụng Java vào các phần phụ thuộc của dự án (bao gồm các tệp jar trong thư mục mapbooking và libs-sources).
Trong cả hai tệp java, hãy làm theo TODO (VIỆC CẦN LÀM) để hoàn thành việc triển khai của bạn

Bạn có thể xem thêm thông tin chi tiết về API REST tại đây.

Khắc phục sự cố:

Khi cố gắng tạo một người bán/dịch vụ mới với MerchantId hoặc IdId hiện có, bạn sẽ nhận được thông báo lỗi sau:

409 Conflict
{
  “code” : 409,
  “errors” :
    [{
        “domain” : “global”,
        “message” : “Requested entity already exists”,
        “reason” : “alreadyExists”,
        “debugInfo” : “detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n"
    }],
  “message” : “Requested entity already exists”,
  “status” : “ALREADY_EXISTS”
}

Khi thực hiện lệnh gọi đến khả năng thay thế bằng merchantId hoặc Id không hợp lệ, lệnh gọi sẽ không gửi thông báo lỗi. Điều này là do các thay đổi đối với vùng khả dụng thông qua RTU hỗ trợ quá trình thực thi không theo đơn đặt hàng và do đó không được liên kết với merchantId hoặc serviceId. Tuy nhiên, các vị trí trong yêu cầu sẽ không được phân phát trong phiên bản chính thức do merchantId hoặc serviceId không hợp lệ. Để đảm bảo các vị trí có thể phân phát, vui lòng thêm người bán hoặc dịch vụ bị thiếu thông qua RTU hoặc nguồn cấp dữ liệu.
Trong tất cả các hàm cập nhật, tham số "updateMask" phải ở định dạng FieldMask (Cánh đồng) để chỉ định các trường cần cập nhật. API chỉ bắt buộc phải thay đổi giá trị của các trường như được chỉ định trong mặt nạ và giữ nguyên các trường khác. Nếu bạn truyền sai chuỗi updateMask, bản cập nhật sẽ không có hiệu lực. Nếu không có mặt nạ trường khi cập nhật, thì thao tác sẽ áp dụng cho mọi trường (như thể mặt nạ trường của tất cả các trường đã được chỉ định). Vì vậy, nếu muốn cập nhật tất cả các trường, bạn chỉ cần để trống updateMask.
Bất kỳ trường nào có giá trị 0 đều không hiển thị trong phản hồi.