Method: echo

渡された clientMessage をエコーします。

このメソッドの目的は、決済インテグレータと Google との間の基本的な接続をテストすることです。

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": string
}
フィールド
requestHeader

object (RequestHeader)

必須: すべてのリクエストに共通のヘッダー。
clientMessage

string

必須: レスポンスでエコーするメッセージ。

レスポンスの本文

echo メソッドのレスポンス オブジェクト。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
フィールド
responseHeader

object (ResponseHeader)

必須: すべてのレスポンスに共通のヘッダー。
clientMessage

string

必須: リクエストで受信したメッセージ。
serverMessage

string

省略可: clientMessage のエコーとは無関係のサーバー メッセージ。