このセクションでは、アクション センターとの統合における 3 つの主要要素について詳しく説明します。これらは、エンドツーエンド ガイドで説明されている手順で使用します。
フィード
フィードは、在庫データをアクション センターに送信するために使用される JSON または pb3 形式のファイルです。これにより、SFTP アップロードを使用してすべてのデータを一度に送信し、販売者、サービス、予約枠を更新できます。
Maps Booking API
Maps Booking API を使用すると、フィードを送信するたびに Actions Center システムのオブジェクトを更新して、情報を最新の状態に保つことができます。この API を使用して、Google で予約のエンドツーエンドの統合を通じて行われた予約をキャンセルすることもできます。
リアルタイム更新は、REST 呼び出しを使用して実装されます。
予約サーバー
アクション センターのエンドツーエンドの統合でお客様に代わって予約を作成するには、予約サーバーを設定する必要があります。
REST API
v3 バージョンは API の最新バージョンで、REST ベースのインターフェースをサポートしています。新しい統合はすべて v3 API を使用する必要があります。
このセクションでは、在庫データをアクション センターに送信するために使用されるフィード ファイルを指定します。フィードの内容によって、提供するサービス、利用できるサービス、サービスが利用できるタイミングが決まります。
Google にフィードを共有する方法については、参照とサンプルのアコーディオンをご覧ください。
在庫フィードの構造は、Google Maps Booking API で定義されます。
次のフィードはすべての統合で必須です。
- 販売者フィード: 販売者に関する情報が含まれています。
また、エンドツーエンドの統合には、次の 2 つのフィードが必須です。
これらのフィードには、必須フィールドと任意のフィールドがあります。省略可能とマークされている項目は、空のフィードから除外できます。
フィード形式は、Protocol Buffer 3 の構文を使用して記述します。フィード ファイルは、プロトコル バッファデータのバイナリ シリアル化（pb3 形式または派生 JSON 形式）としてアップロードできます。フィードは JSON 形式でアップロードすることをおすすめします。
アップロードする前に、フィードを圧縮するために gzip を使用することをおすすめします。
このガイドでは、Actions Center のプロトコル バッファについて説明します。プロトコル バッファを使用して pb3 ファイルを生成する方法の一般的な情報については、Java の例をご覧ください。