RequestHeader

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

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

string

REQUIRED:這個要求的專屬 ID。

這個字串的長度上限為 100 個字元,且只能包含「a-z」、「A-Z」、「0-9」、「:"」、「-」和「_」字元。

requestTimestamp

string (int64 format)

REQUIRED:這個要求的時間戳記,以自 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)

REQUIRED:此要求的版本。

版本

版本物件,這是傳統 a.b.c 版本結構的結構化形式。我們保證與相同號碼的主要版本相容。請注意,次要版本和修訂版本可能會經常變動,恕不另行通知。整合服務供應商必須支援同一個主要版本的所有要求。

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

integer

REQUIRED:主要版本。如果 SSL 的相容性要求不同版本,就不保證會相容。

minor

integer

REQUIRED:子版本。這代表重大錯誤修正。

revision

integer

REQUIRED:子版本。這代表小錯誤修正。