渡された clientMessage
をエコーバックします。
この方法は、決済インテグレータと Google との間の基本的な接続をテストするためのものです。
このメソッドは、セキュリティ制約が適切に保持されているかどうかをテストするために、有効または無効なパラメータを使用して 1 分に複数回呼び出されることがあります。Google はまた、インテグレータの指示でも Google の指示でも、このメソッドを呼び出します。Google がこれを 10 秒に 1 回より速く呼び出すことはなく、15 分間に 30 回を超えることはありません。
セキュリティ制約テストの例を以下に示します(ただしこれらに限定されません)。
- 決済インテグレータのエンドポイントが脆弱な暗号スイートとネゴシエートしないようにテストします。
- 決済インテグレータのエンドポイントが TLS 1.2 以外にネゴシエートしないことを確認するテスト
- 決済インテグレータのエンドポイントが HTTP をサポートしていないことを確認するためのテスト。
- 決済インテグレータのエンドポイントで既知の PGP 署名鍵が少なくとも 1 つ必須であることをテストしてください。
- 決済インテグレータのエンドポイントが、既知および不明な複数の PGP 鍵署名(期限切れおよび有効)をサポートしていることを確認するテスト。
- 決済インテグレータが厳格な JSON 解析のみをサポートしていることを確認するためのテスト。
リクエストの処理中にエンドポイントでエラーが発生した場合、このエンドポイントからのレスポンスの本文は
型になります。ErrorResponse
リクエストの例を次に示します。
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "ZWNobyB0cmFuc2FjdGlvbg",
"requestTimestamp": "1481899949606"
},
"clientMessage": "client message"
}
レスポンスの例を次に示します。
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"clientMessage": "client message",
"serverMessage": "server message"
}
HTTP リクエスト
POST https://www.integratorhost.example.com/v1/echo
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"requestHeader": {
object ( |
フィールド | |
---|---|
requestHeader |
必須: すべてのリクエストに共通のヘッダー。 |
clientMessage |
必須: レスポンスでエコーするメッセージ。 |
レスポンスの本文
echo メソッドに対するレスポンス オブジェクト。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"responseHeader": {
object ( |
フィールド | |
---|---|
responseHeader |
必須: すべてのレスポンスに共通のヘッダー。 |
clientMessage |
必須: リクエストで受信されたメッセージ。 |
serverMessage |
省略可: サーバー メッセージ。エコーされる |
RequestHeader
サーバーに送信されるすべてのリクエストに定義されるヘッダー オブジェクト。
JSON 表現 |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
フィールド | |
---|---|
requestId |
必須: このリクエストの一意の識別子。 これは、最大長が 100 文字で、「a ~ z」、「A ~ Z」、「0 ~ 9」、「:」、「-」、「_」のみを含む文字列です。 |
requestTimestamp |
必須: エポックからのミリ秒単位で表されるこのリクエストのタイムスタンプ。受信者は、このタイムスタンプが「現在」の ± 60 秒であることを確認する必要があります。このリクエストのタイムスタンプは、再試行時にべき等ではありません。 |
userLocale |
非推奨: 2 文字または 3 文字の ISO 639-2 Alpha-3 言語コード。必要に応じてハイフンと ISO 3166-1 Alpha-2 国コード(「pt」、「pt-BR」、「fil」、「fil-PH」など)が続きます。レスポンスの |
protocolVersion |
必須: このリクエストのバージョン。 |
バージョン
従来の a.b.c
バージョン構造の構造化されたバージョン オブジェクト。同じ番号のメジャー バージョンは互換性が保証されています。マイナーおよびリビジョンは、予告なく頻繁に変更される場合があります。インテグレータは、同じメジャー バージョンのすべてのリクエストをサポートする必要があります。
JSON 表現 |
---|
{ "major": integer, "minor": integer, "revision": integer } |
フィールド | |
---|---|
major |
必須: メジャー バージョン。これは、異なるバージョンの互換性リクエストには互換性が保証されていないため、マークされています。 |
minor |
必須: マイナー バージョン。これは、重要なバグ修正を意味します。 |
revision |
必須: マイナー バージョン。マイナーなバグ修正を示します。 |