リアルタイム更新の実装を開始するには、Java リアルタイム更新 API クライアントをダウンロードしてください。
前提条件:
サービス アカウントを作成して、秘密鍵をダウンロードします。
始める:
- Java クライアント ライブラリをダウンロードし、ファイルを解凍して「mapsbooking」パッケージを取得します。
-
IDE で Java プロジェクトを作成し、このリポジトリからサンプルコード InventoryUpdate.java と BookingNotification.java をダウンロードします。
git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
これらのファイルを src ディレクトリの Java プロジェクトにインポートします。
- 秘密鍵(JSON ファイル)のコピーを src ディレクトリに作成します。
- Java クライアント ライブラリをプロジェクトの依存関係に追加します(mapsbooking ディレクトリと libs-sources ディレクトリに JAR ファイルを含めます)。
- 両方の Java ファイルで、TODO に沿って実装を完了します。
REST API の詳細については、こちらをご覧ください。
トラブルシューティング:
-
既存の merchantId または serviceId を使用して新しい販売者/サービスを作成しようとすると、次のエラー メッセージが表示されます。
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” }
- 無効な merchantId または serviceId を使用して replace availaiblity 呼び出しを実行しても、エラー メッセージはスローされません。これは、RTU を介した空きスロットの変更が順序外実行をサポートしているため、merchantId または serviceId に関連付けられていないためです。ただし、merchantId または serviceId が無効であるため、リクエスト内のスロットは本番環境で配信されません。予約枠をサービス提供可能にするには、不足している販売者またはサービスを RTU またはフィード経由で追加してください。
- すべての更新関数で、更新するフィールドを指定するには、パラメータ「updateMask」を FieldMask 形式にする必要があります。API は、マスクで指定されたフィールドの値のみを変更し、他のフィールドは変更しない必要があります。間違った updateMask 文字列を渡すと、更新は適用されません。更新時にフィールド マスクが存在しない場合、オペレーションはすべてのフィールドに適用されます(すべてのフィールドのフィールド マスクが指定されている場合と同様に)。したがって、すべてのフィールドを更新する場合は、updateMask を空に設定します。
- 値がゼロのフィールドはレスポンスに表示されません。