如何在BigQuery REST API GET请求中正确传递JSON格式formatOptions参数

解决方法 #

你需要将复合结构的formatOptions参数展开为点分隔的扁平参数传递，不要直接传入JSON字符串，操作规则如下：

• 嵌套字段的参数名格式为父字段名.子字段名，此处对应formatOptions.useInt64Timestamp，直接赋值为true即可
• 正确的请求URL示例：

https://bigquery.googleapis.com/bigquery/v2/projects/{{projectId}}/queries/{{JOBid}}?maxResults=1&formatOptions.useInt64Timestamp=true

如果formatOptions下存在多个需要配置的字段，依次按照上述格式追加参数即可。

报错原因 #

BigQuery API的GET查询参数仅支持直接绑定字符串、布尔值、数字等原始类型，formatOptions属于复合消息类型，不能直接作为JSON串传入，必须展开为多个原始类型的点式参数才能被正确解析。

内容的提问来源于stack exchange，提问作者MatejC