Transactions API - Speaker Deck

Transactions API

by Daisuke Kobayashi

Slide 1

Slide 1 text

Transactions API Daisuke Kobayashi

Slide 2

Slide 2 text

自己紹介小林大介 / @0rga（オーじゃなくてゼロ）株式会社ぐるなび 8月に子供が産まれて育休中のエンジニア。

Slide 3

Slide 3 text

今まで作ったもの

Slide 4

Slide 4 text

目次 ● Transactions APIの使い方 ● ぐるなびで飲食店を予約できるアクションを作った時の話

Slide 5

Slide 5 text

Transactions APIの使い方

Slide 6

Slide 6 text

Transactions APIとは通常は利用規約で制限されている、 Google Assistant向けアクションでの購入、注文、予約といった行動を実装できる機能。

Slide 7

Slide 7 text

Transactions APIとは Transactions API使わなくても自前のAPI使えば購入注文予約のアクションを実装はできると思うけど、それじゃリリースレビュー通しませんよ、という事。

Slide 8

Slide 8 text

Transactions APIを使用した一連の流れの例（飲食店の予約の場合）

Slide 9

Slide 9 text

取引可能判定チェック ⇣ 住所取得 ⇣ ユーザ情報取得 ⇣ 取引確認＆作成 ⇣ 取引状態更新

Slide 10

Slide 10 text

取引可能判定チェック TransactionRequirements class 任意項目のひとつ。ユーザがTransaction可能な状態かどうかをチェックできます。ユーザが取引不可の状態（決済情報を未登録など）でも取引確定の手前まで進めますが、最後の最後でダメって言うのはUXが著しく良くないのでおすすめできません。コード例は決済なしのTransaction（予約）ですが、決済ありの場合は、paymentOptionsのパラメータを指定する必要があります。

Slide 11

Slide 11 text

取引可能判定チェック

Slide 12

Slide 12 text

取引可能判定チェック ⇣ 住所取得 ⇣ ユーザ情報取得 ⇣ 取引確認＆作成 ⇣ 取引状態更新

Slide 13

Slide 13 text

住所取得 DeliveryAddress class 任意項目のひとつ。作ろうとしているTransactionに住所情報が必要ない場合は実行しなくて良いです。ユーザが住所を登録しておりかつユーザの許可が降りた場合住所情報が取得できます。取得できる内容は下記の通り。電話番号も住所の一部です。

Slide 14

Slide 14 text

住所取得パラメータのreasonに住所を必要とする理由が書けますが、【, 配送先をGoogle…】以下は固定文言になっています。固定文言なしのフリーフォーマットが欲しい所です。予約は配送しませんので。

Slide 15

Slide 15 text

住所取得

Slide 16

Slide 16 text

取引可能判定チェック ⇣ 住所取得 ⇣ ユーザ情報取得 ⇣ 取引確認＆作成 ⇣ 取引状態更新

Slide 17

Slide 17 text

ユーザ情報取得 Permission class 任意項目のひとつ。こちらもユーザ情報が不要な場合は実行しなくて良いです。名前と位置情報が取得できます。住所取得でも名前が取得できますが、あちらはフルネーム（フリーフォーマット）で返ってくる為、姓名分割は正規表現の限界に挑むことになります。こちらは最初から姓名別で取得できますので、ベストな方を使いましょう。

Slide 18

Slide 18 text

ユーザ情報取得位置情報には２つの種類がありますのでご注意下さい。 ● DEVICE_PRECISE_LOCATION スマートフォン用。正確な緯度経度などが返ってきます。 ● DEVICE_COARSE_LOCATION Googleホームデバイス用。郵便番号、市および国コードなどが返ってきます。

Slide 19

Slide 19 text

ユーザ情報取得住所取得と同様にパラメータのcontextにユーザ情報を取得する理由を書けますが、【名前と現在地が…】以降は固定文言です。 [はい / いいえ]のサジェストも出す事ができません。

Slide 20

Slide 20 text

ユーザ情報取得

Slide 21

Slide 21 text

取引可能判定チェック ⇣ 住所取得 ⇣ ユーザ情報取得 ⇣ 取引確認＆作成 ⇣ 取引状態更新

Slide 22

Slide 22 text

取引確認＆作成 TransactionDecision class 必須項目。これこそがTransaction。組み立てたカート情報（order）を元にユーザに決済するかどうかを尋ねる事が出来ます。コード例のようにorderOptionsでEMAILを指定する事で、通常はアカウントリンキング（OAuth認証）をしないと取得できないユーザの EMAILアドレスを取得できます。取引完了後にメールを送る場合は取得しておきましょう。

Slide 23

Slide 23 text

※ orderの中身はGoogleActionsV2OrdersProposedOrderを参照して下さい。取引確認＆作成

Slide 24

Slide 24 text

取引確認＆作成 ※キャプチャはサンプルコードのもの

Slide 25

Slide 25 text

取引可能判定チェック ⇣ 住所取得 ⇣ ユーザ情報取得 ⇣ 取引確認＆作成 ⇣ 取引状態更新

Slide 26

Slide 26 text

取引状態更新 OrderUpdate class 必須項目。取引の状態を更新する事ができます。取引の状態は随時更新する必要があり、 ● CREATED：取引作成 ● REJECTED：取引キャンセル ● CONFIRMED：取引受注済 ● FULFILLED：取引完了などの状態があります。

Slide 27

Slide 27 text

取引状態更新更新する度にユーザのGoogle Assistantの購入履歴にある該当の取引情報が更新されていきます。基本的にリアルタイム更新が求められますので、商品を発送したり、予約の時間になったら状態更新をしましょう。なお、別途APIを叩くことでも状態は更新可能ですので、バッチなどで更新するのが便利かもしれません。

Slide 28

Slide 28 text

取引状態更新なお、 ● TransactionDecision関数を実行 ● 自前の購入注文予約APIを実行は同時には出来ません。どうしたってタイムラグが発生します。 TransactionDecision関数を実行した後に自前のAPIを実行し、自前のAPIがコケた場合は、取引情報をREJECTEDに更新するなどの工夫が必要です。

Slide 29

Slide 29 text

取引状態更新 ※ OrderUpdateの引数はGoogleActionsV2OrdersOrderUpdateを参照して下さい。

Slide 30

Slide 30 text

取引状態更新 ※ FULFILLEDの状態の一例

Slide 31

Slide 31 text

以上が一連の流れの例になります

Slide 32

Slide 32 text

実は… 予約アクション（0円取引）はTransactions APIでは非推奨になりました。悲しい事やで。ですので、皆さんがこれからTransactions APIを使用して取引アクションを作る場合は、決済が実際にある購入注文で作る事をオススメします。

Slide 33

Slide 33 text

もしも時間が余ってたら、ぐるなびで飲食店を予約できるアクションを作った時の話を少し。

Slide 34

Slide 34 text

どんな予約アクションを作ろうかな

Slide 35

Slide 35 text

人数指定お店の予約コースの予約席のタイプ NoShow 対策日付指定エリア指定料理ジャンルの指定

Slide 36

Slide 36 text

全部言わせる…？

Slide 37

Slide 37 text

コースの予約をしますか？何日に予約をしますか？何時に予約をしますか？お席のタイプはカウンターですか？テーブル？それとも掘りごたつですか？何人ですか？場所はどこにしますか？料理のジャンルは何にしますか？

Slide 38

Slide 38 text

No content

Slide 39

Slide 39 text

VUIで詳細検索はダメ

Slide 40

Slide 40 text

何人ですか？

Slide 41

Slide 41 text

何人ですか？つくったもの ● 飲食店を探すエリアはユーザの端末の位置情報を取得し、徒歩圏内に収める。 ● 予約できる時間は現在の時刻から30分後に固定。 ● コース予約は無くし、空席予約のみにする。予約に必要な情報は人数だけに絞る事によりシンプルなVUIにしました。行きたいお店をじっくり探すのは不向きだけど、近くで2次会を探すなどのユースケースでは抜群の便利さを実現しています。

Slide 42

Slide 42 text

ありがとうございました