JavaScript ウェブボタン

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Google Wallet API を使用すると、ユーザーはウェブから Google ウォレットにオブジェクトを追加できます。 ユーザーはウェブサイトからカードを直接追加できます。

このリファレンスでは、Google Wallet API ボタンを表示する HTML 要素 g:savetoandroidpay と、ウェブサービスを記述する Google への JSON ウェブトークンの詳細について説明します。

Google Wallet API JavaScript

読み込み時に g:savetoandroidpay HTML タグを自動的に解析するには、標準の JavaScript を使用します。

<script src="https://apis.google.com/js/platform.js" type="text/javascript"></script>

AJAX アプリケーションや Google Wallet API ボタンの明示的なレンダリングには、"parsetags": "explicit" パラメータを含めます。

<script src="https://apis.google.com/js/platform.js" type="text/javascript">
  {"parsetags": "explicit"}
</script>

g:savetoandroidpay HTML タグ

g:savetoandroidpay 名前空間タグは、[Google ウォレットに保存] ボタンの配置とさまざまな属性を定義します。HTML と JWT をサーバー側でレンダリングする場合は、このタグを使用します。

<g:savetoandroidpay jwt="JWT" onsuccess="successHandler" onfailure="failureHandler" />
項目 必須 説明
height 文字列 N 表示するボタンの高さ。指定できる値は small(高さ 30 ピクセル)と standard(高さ 38 ピクセル)です。height のデフォルトは small です。height 設定が異なるボタンの例については、Google Wallet API のボタンをご覧ください。
jwt 文字列 Google Wallet API JWT。
onsuccess 文字列 N 成功成功コールバック ハンドラ関数の文字列名。
onfailure 文字列 N 保存エラーのコールバック ハンドラ関数の文字列名。この関数には、errorCode と errorMessage を含むエラー オブジェクトが渡されます。
onprovidejwt 文字列 N JWT ハンドラ関数の文字列名。この関数の目的は、オブジェクトが Google ウォレットに保存される前に JWT データをインターセプトし、場合によっては操作することです。この関数はパラメータを受け入れないため、JWT を文字列として返す必要があります。イベント ハンドラを実装すると、this.getOpenParams().renderData.userParams.jwt フィールドの元の JWT データを取得できます。
size 文字列 N 表示するボタンの幅。sizematchparent に設定すると、親要素の幅と同じ幅にできます。または、text 設定の幅に合わせて幅が拡張されるように、size を未定義のままにします。size 設定が異なるボタンの例については、Google Wallet API のボタンをご覧ください。
text 文字列 N 非推奨
textsize 文字列 N textsize=large を指定すると、特別な UI が必要な場合、テキストサイズとボタンサイズが大幅に増加します。
theme 文字列 N 表示するボタンのテーマ。有効な値は darklight です。デフォルトのテーマは dark です。theme 設定のボタンの例については、Google Wallet API ボタンをご覧ください。

gapi.savetoandroidpay.render 関数

この関数を使用すると、Google Wallet API ボタンを明示的にレンダリングできます。

gapi.savetoandroidpay.render("dom-container",{
  "jwt": "JWT",
  "onsuccess": "successHandler",
  "onfailure": "failureHandler"
});
項目 必須 説明
dom-container 文字列 Google Wallet API ボタンを配置するコンテナの ID。
jwt 文字列 保存するコンテンツを定義する JWT。
onsuccess 文字列 N 保存成功コールバック ハンドラ関数の文字列名。
onfailure 文字列 N 保存エラーのコールバック ハンドラ関数の文字列名。この関数には、errorCode と errorMessage を含むエラー オブジェクトが渡されます。
onprovidejwt 文字列 N JWT ハンドラ関数の文字列名。この関数の目的は、オブジェクトが Google ウォレットに保存される前に JWT データをインターセプトし、場合によっては操作することです。この関数はパラメータを受け入れないため、JWT を文字列として返す必要があります。イベント ハンドラを実装すると、this.getOpenParams().renderData.userParams.jwt フィールドの元の JWT データを取得できます。

Google Wallet API のエラーコードとメッセージ

以下の表は、オブジェクトが JavaScript ボタンを使用して正常に保存できない場合の、エラー オブジェクトでエラー コールバック関数に渡されるエラーコードとデフォルトのエラー メッセージを示しています。

        {
          "errorCode": "errorCode",
          "errorMessage": "errorMessage"
        }
errorCode errorMessage
SERVICE_FAILURE Google ウォレット サーバーでエラーが発生しました。
CLASS_NOT_FOUND オブジェクトで参照されているクラスが見つかりませんでした。
CLASS_MISMATCH オブジェクトは同じ型で、囲まれているクラスを参照している必要があります。
ORIGIN_MISMATCH ボタンのオリジンがオリジンのリストで指定されているものと一致しません。
INVALID_NUM_TYPES 正確に 1 つのオブジェクトのタイプを指定できます。
INVALID_SIGNATURE 署名を確認できませんでした。
INVALID_DUPLICATE_IDS オブジェクトやクラスを重複させることはできません。
INVALID_JWT JWT が無効です。
INVALID_EXP_IAT JWT が期限切れになっている、または将来発行された。
INVALID_AUD AUD フィールドの値が無効です。
INVALID_TYP TYP フィールドの値が無効です。
INVALID_NUM_OBJECTS ポイントカード、ギフトカード、クーポンには 1 つのオブジェクトと最大 1 つのクラスを指定できます。
MALFORMED_ORIGIN_URL 送信元の URL の形式が正しくありません。URL にはプロトコルとドメインを含める必要があります。
MISSING_ORIGIN 出発地を指定する必要があります。
MISSING_FIELDS 囲まれたオブジェクトまたはクラスに必須フィールドがありませんでした。

Localization

JavaScript ボタンの言語は以下の条件に基づいて変更されます。

  1. ユーザーが Google にログインしている場合、ボタンはユーザーの Google アカウント プロフィールで指定された言語で表示されます。ユーザーが Google アカウントの優先言語を変更する方法については、言語を変更するをご覧ください。
  2. ユーザーが Google にログインしていない場合は、HTTP ヘッダーの ACCEPT-LANGUAGE 値が使用されます。

上記のロジックに基づいてボタンが正しい言語で表示されない場合、または言葉が不自然な場合は、サポートチームにお問い合わせください