发送到服务器的所有请求中定义的标头对象。
JSON 表示法 |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
字段 | |
---|---|
requestId |
必需:此请求的唯一标识符。 这是一个最大长度为 100 个字符的字符串,并且仅包含字符“a-z”“A-Z”“0-9”“:”“-”和“_”。 |
requestTimestamp |
必需:此请求的时间戳,以自纪元以来的毫秒数表示。接收者应验证此时间戳是否为“现在”的 ± 60 秒。此请求时间戳在重试时不具有幂等性。 |
userLocale |
已弃用:由两个或三个字母组成的 ISO 639-2 Alpha 3 语言代码(可视需要后跟连字符和 ISO 3166-1 Alpha-2 国家/地区代码),例如“pt”“pt-BR”“fil”或“fil-PH”。使用此方法有助于驱动响应中的 |
protocolVersion |
必需:此请求的版本。 |
版本
Version 对象,是经典 a.b.c
版本结构的结构化形式。相同编号的主要版本保证兼容。请注意,次要和修订可能会频繁变动,恕不另行通知。集成商必须支持针对同一主要版本的所有请求。
JSON 表示法 |
---|
{ "major": integer, "minor": integer, "revision": integer } |
字段 | |
---|---|
major |
必需:主要版本。此属性会被标记为不同版本的兼容性请求,但这并不保证兼容。 |
minor |
必需:次要版本。这表示修复了重大问题。 |
revision |
必需:次要版本。表示小的 bug 修复。 |