Java Booking API'si istemcisi

Gerçek zamanlı güncellemeleri uygulamaya başlamak için Java gerçek zamanlı güncelleme API istemcimizi indirebilirsiniz.

Ön koşul:

Hizmet hesabınızı oluşturun, özel anahtarınızı indirin.

Başlayın:

  1. "mapsbooking" paketini almak için dosyanın sıkıştırmasını açarak Java istemci kitaplığı'nı indirin.
  2. IDE'nizde bir java projesi oluşturun, şu depodan InventoryUpdate.java ve BookingNotification.java kodlarını indirin:

    git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
    

    ve bunları src dizini altındaki Java projenize aktarın.

  3. Özel anahtarınızın (JSON dosyası) bir kopyasını src dizininde oluşturun.
  4. Java İstemci Kitaplığı'nı projenizin bağımlılıklarına ekleyin (jar dosyalarını mapsbooking ve libs-sources dizinine ekleyin).
  5. Her iki Java dosyasında da uygulamalarınızı tamamlamak için YAPILACAKLAR'ı uygulayın

REST API hakkında daha fazla bilgiyi burada bulabilirsiniz.

Sorun giderme:

  1. Mevcut bir merchantId veya serviceId ile yeni satıcı/hizmet oluşturmaya çalıştığınızda aşağıdaki hata mesajını alırsınız:

    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”
    }
    
  2. Geçersiz bir merchantId veya hizmet kimliği ile değiştirme kullanılabilirliği çağrısı yapıldığında çağrıda hata mesajı vermez. Bunun nedeni, kullanılabilirlik slotlarında RTU'lar aracılığıyla yapılan değişikliklerin sipariş dışı yürütmeyi desteklemesi ve dolayısıyla bir merchantId veya serviceId ile ilişkili olmamasıdır. Ancak istekteki alanlar, geçersiz merchantId veya serviceId nedeniyle üretimde sunulmaz. Slotları yayınlanabilir hale getirmek için lütfen RTU'lar veya feed'ler aracılığıyla eksik satıcıyı veya hizmeti ekleyin.
  3. Tüm güncelleme işlevlerinde, güncellenecek alanları belirtmek için "updateMask" parametresi FieldMask biçiminde olmalıdır. API'nin yalnızca maskede belirtilen alanların değerlerini değiştirip diğerlerini olduğu gibi bırakması gerekir. Yanlış updateMask dizesini iletirseniz güncelleme geçerli olmaz. Güncelleme sırasında alan maskesi mevcut değilse işlem tüm alanlar için geçerli olur (tüm alanların alan maskesi belirtilmiş gibi). Dolayısıyla, tüm alanları güncellemek isterseniz updateMask'i boş ayarlamanız yeterlidir.
  4. Değeri sıfır olan alanlar yanıtta gösterilmez.