フィードの概要

このセクションでは、Actions Center との統合に関する主な 3 つのポイントについて説明します。各ポイントは、エンドツーエンド ガイドに記載されている手順で使用します。

フィード

フィードは、在庫データを Actions Center に送信するために使用される JSON 形式または pb3 形式のファイルです。このファイルを使って SFTP アップロード経由ですべてのデータをまとめて送信し、販売者、サービス、予約枠を更新できます。

Maps Booking API

Maps Booking API を使用すると、フィードを送信するたびに Actions Center システムのオブジェクトが更新され、情報をいつでも最新の状態に保つことができます。この API を使って、「Google で予約」のエンドツーエンドの統合を介して行われた予約をキャンセルすることもできます。

リアルタイム更新は REST 呼び出しを使用して実装されます。

予約サーバー

Actions Center のエンドツーエンドの統合で予約を自動に作成するには、予約サーバーを設定する必要があります。

REST API

v3 バージョン は API の最新バージョンで、REST ベースのインターフェースをサポートしています。新しい統合では必ず v3 API を使用する必要があります。

このセクションでは、在庫データを Actions Center に送信するために使用するフィード ファイルを指定します。フィードの内容では、提供するサービス、利用可能なサービス、サービスを利用できる時期を定義します。

これらのフィードを Google と共有する方法については、参照とサンプルをご覧ください。

空き情報フィードの構成は、Google Maps Booking API によって定義されます。

次のフィードは、どの統合でも必須です。

• 販売者フィード: 販売者を説明するデータが含まれます。

また、エンドツーエンドの統合には、次の 2 つのフィードが必須です。

• サービス フィード: 販売者が提供するサービスについて説明します。
• 空き状況フィード: 販売者が提供するサービスを利用できる時間枠を指定します。

これらのフィードには、必須フィールドと任意のフィールドがあります。省略可能とマークされているフィールドは、空の場合はフィードから除外できます。

フィード形式は、Protocol Buffer 3 の構文を使用して記述します。フィード ファイルは、pb3 形式または派生 JSON 形式で Protocol Buffer データのバイナリをシリアル化してアップロードできます。フィードを JSON 形式でアップロードすることをおすすめします。

アップロード前に gzip を使用してフィードを圧縮することをおすすめします。

このガイドは、Actions Center の Protocol Buffer 専用です。Protocol Buffer を使用して pb3 ファイルを生成する方法についての概要は、Java の例をご覧ください。