Method: echo

對傳入的 clientMessage 發出回音。

這種方法的目的是測試付款整合商與 Google 之間的基本連線能力。

如果端點在處理要求時發生錯誤，來自這個端點的回應就會是 ErrorResponse 類型。

如果這個方法未傳回 HTTP 200，這項查詢的回應可能會空白。在某些情況下，使用 ErrorResponse 搭配清楚的說明，協助攻擊者瞭解其他整合商的帳戶 ID，則回應主體是空白的。在這類情況下，只要簽署金鑰不相符、找不到付款整合商 ID，或是加密金鑰不明，這個方法就會傳回主體為空白的 HTTP 404。如果要求簽章可供驗證，回應主體中會傳回與錯誤相關的其他資訊。

以下是要求範例：


{
  "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://vgw.googleapis.com/secure-serving/gsp/v1/echo/:PIAID

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
欄位
requestHeader

object (RequestHeader)

必要項目：所有要求的通用標頭。
clientMessage

string

必要項目：回應中的 echo 訊息。

回應主體

echo 方法的回應物件。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
欄位
responseHeader

object (ResponseHeader)

必要項目：所有回應的通用標頭。
clientMessage

string

必要項目：要求中收到的訊息。
serverMessage

string

選用：伺服器訊息，與被回應的 clientMessage 無關。

RequestHeader

針對傳送至伺服器的所有要求所定義的標頭物件。

JSON 表示法 
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
欄位
requestId

string

必要項目：這項要求的專屬 ID。

這是一個長度上限為 100 個字元的字串，並且只包含「a-z」、「A-Z」、「0-9」、「:」、「-」和「_」等字元。
requestTimestamp

string (int64 format)

必要項目：這項要求的時間戳記，以 Epoch 紀元時間起算的毫秒為單位。接收端應驗證這個時間戳記是否為「現在」的 ±60 秒。重試時，此要求時間戳記並不是冪等的。
userLocale
(deprecated)

string

已淘汰：由兩或三個字母組成的 ISO 639-2 Alpha 3 語言代碼，後面可選擇加上連字號和 ISO 3166-1 Alpha-2 國家/地區代碼，例如「pt」、「pt-BR」、「fil」或「fil-PH」。請使用這個屬性來驅動回應中的 userMessage 欄位。
protocolVersion

object (Version)

必要項目：這項要求的版本。

版本

版本物件是傳統版 a.b.c 版本結構的結構化格式。相同數字的主要版本保證能夠相容。請注意，輕微和修訂可能經常變更，恕不另行通知。整合商必須支援相同主要版本的所有要求。

JSON 表示法 
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
欄位
major

integer

必要項目：主要版本。標示為不同版本的廣告素材不保證能夠相容。
minor

integer

必要項目：子版本。這表示重大錯誤修正。
revision

integer

必要項目：子版本。這代表小錯誤修正。