このページは Cloud Translation API によって翻訳されました。

Retail Ordering v1 統合の可用性の向上

このチュートリアルでは、次のことについて説明します。

ユーザーに対する可用性の表示方法と、必要なデータの種類の概要
在庫状況データをフィード内の action_link にエンコードする具体的な手順
1 日のうちに変更があった場合に在庫状況を更新する方法
可用性に関する期待値

在庫状況メタデータに加えて、配送または受け取りに関連する料金、最小注文金額に関するメタデータを提供することも求められます。在庫状況、手数料、最低注文数を示す完全なフィードサンプルについては、Retail Ordering v1 フィードサンプルをご覧ください。

提供する必要のある情報

このエクスペリエンスに対する販売注文の在庫状況は、日レベルの粒度で収集されます。この空室状況データは、提供されている最も早い日付に基づいて、「本日利用可能」、「明日利用可能」、「DD/MM 利用可能」などのメッセージとともに、料金と最低注文金額とともに表示されます。

このデータをフィードで送信すると、将来の日付や、ユーザーが注文したり、各日付の集荷や配送をスケジュール設定した最新の時刻を送信したりします。この 2 つの情報は、それぞれフルフィルメント日と最後の注文時間です。

たとえば、今日の日付が 2021 年 3 月 23 日で、明日 4 時までに配達される予定の場合、在庫状況として指定するデータは次のようになります。

納品日: 2021 年 3 月 24 日
最終注文時間：2021/03/23 4:00 PM

最後の注文日時が含まれているので、その時間が経過すると、Google フロントエンドは最後の注文日時が過ぎると次に利用可能な日付に自動的に更新されます。

新しい販売者フィードを毎日アップロードする場合は、新しい在庫状況データを含めてください。フロントエンドには現在の在庫状況のみが表示されるので、特定の場所の次の 3 ～ 5 つの提供日程を指定するだけで済みます。これにより、フロントエンドは現在の在庫状況を表示するとともに、最後の注文時間の経過後に次の在庫状況を表示できます。

フィードを使用して在庫状況を指定する

アクションリンクを使用できるかどうかは、販売者フィード action_link メッセージの order_online_metadata フィールドの一部として含めます。販売者とフルフィルメントオプションごとに、パスに AvailableDay メッセージのリストがあります。

Merchant.action_link.order_online_metadata.fulfillment_option.available_day

メッセージは次の形式にする必要があります。

{
  "fulfillment_date": {
    "year": "2020",
    "month": "10",
    "day": "1"
  },
  "last_ordering_time":  {
    "seconds": "1601614800"  // 2020/10/1, 10pm
  }
}

この形式の fulfillment_date は、可用性がある年、月、日です。この日付は、この販売者が指定した場所を参照する必要があります。

last_ordering_time は UNIX タイムスタンプ（秒）です。これはタイムゾーンに依存せず、販売者が fulfillment_date で指定された日付で注文を受け付けることができる最後のタイミングを示します。最後の注文時刻は、フルフィルメント日より前または処理中の時間になります。最後の注文期限が過ぎると、Google は指定されたフルフィルメント日の可用性の表示を自動的に停止し、次の利用可能なフルフィルメント日に基づいて在庫状況を表示します。

order_online_metadata のリファレンス定義については、販売者フィードリファレンスをご覧ください。JSON 形式の在庫状況を含むフィードサンプルについては、フィードのサンプル Retail Ordering + Metadata をご覧ください。

リアルタイムアップデートで在庫状況を更新

日次フィードを送信するまでの間に店舗の提供または受け取りの可否が変更された場合は、リアルタイム更新の REST API を使用して、ユーザーに表示される在庫状況を更新できます。

一度に更新できるのは 1 つの販売者です。更新を行う際、更新する販売者と、API エンドポイントの一部として更新する必要があるフィールドを指定します。リクエストの本文に、これらのフィールドの新しいデータを含めます。更新されるすべてのフィールドは、指定された情報に置き換えられます。

可用性を更新するには、次のエンドポイントにパッチリクエストを行います。

PATCH https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}?updateMask=action_link

リクエストの本文は action_link のみを含む販売者オブジェクトになります（updateMask に action_link のみを含めるため）。

{
  "action_link": [
    ..., // all required action_link fields here
    "order_online_metadata": {
      "fulfillment_option": [
        "fulfillment_type": "FULFILLMENT_TYPE_DELIVERY",
        "available_day": [ // Include the updated availability here
          {
            "fulfillment_date": {
              "year": "2020",
              "month": "10",
              "day": "1"
            }
            "last_ordering_time": {
              "seconds": "1601614800"  // 2020/10/1, 10pm
            }
          },
          ... // Other updated availability_days
        ]
      ]
    }
  ]
}

API リクエストが成功すると、レスポンスには新しく更新されたデータを含む販売者オブジェクトが含まれます。

販売者更新メソッドの完全なリファレンス仕様については、メソッド:inventory.partners.merchants.patch をご覧ください。

可用性の精度

「Google で予約」では、さまざまな要因によって可用性の詳細が変わります。以下のような要因があります。

注文数に応じた在庫状況の変更
注文や購入手続きの完了までの時間に基づく在庫状況の変化
フィードまたはリアルタイムアップデートを使用して在庫状況の変更が更新されるまでのレイテンシ

これらの要因のいずれかが、ユーザーに最初に表示される在庫状況が、ご購入手続きの際に表示される最終的な在庫状況と変わる可能性があります。可用性の実装の目的は、これらを完全に排除することではなく、可能な限り多くの情報をユーザーに明確に提示することです。

パートナーは、ベストエフォートベースで可能な限り正確な在庫状況をできるだけ多くユーザーに提供する実装を提供することが求められます。また、注文の詳細に応じて在庫状況が変化する場合は、これをユーザーに明確に示す必要があります。ケースで何をする必要があるかが明確にわからない場合は、「Google で予約」の担当者にお問い合わせください。