谷歌云翻译高级版(V3)中的parent参数指什么?该如何填写、从何处获取?
Google Translate API v3
parent参数说明 参数核心定义
parent是谷歌云v3版接口强制要求的统一路径参数,作用是明确当前请求对应的资源归属,接口拿到这个参数后会完成两项处理:
- 校验调用者是否具备对应资源的操作权限
- 将请求转发到指定服务区域的后端节点完成处理
缺少这个参数的话,翻译接口会直接抛出参数缺失的错误,不会返回任何翻译结果。
固定填写规则
这个参数的格式是谷歌云全局统一规定的,没有自由发挥的空间,固定拼接模板为:projects/{你的项目ID}/locations/{服务区域}
和你看到的官方示例代码的写法完全对应:
parent: `projects/${projectId}/locations/${location}`
参数值的获取渠道
- 项目ID:是你在谷歌云创建项目时生成的唯一标识,是字母、数字、连字符组成的字符串,既不是你自定义的项目展示名称,也不是纯数字格式的项目编号,可以在谷歌云控制台的项目选择下拉列表里直接复制
- 服务区域:指翻译服务的部署节点位置
- 没有特殊数据合规要求的话,直接填默认值
global即可,接口会自动把请求路由到离你最近的节点 - 如果有数据必须留在特定区域的合规要求,就填你开启翻译服务时选定的具体区域代码,比如
us-central1、asia-east1
- 没有特殊数据合规要求的话,直接填默认值
常见使用注意事项
- 不要简化参数内容,必须严格按照模板拼完整路径,缺失
projects/、/locations/这类固定片段,都会直接触发参数格式校验报错 - 不要把纯数字的项目编号填到项目ID的位置,否则会直接报权限不足
- 如果不使用
global默认值,一定要确保填写的区域和控制台开启翻译服务时选定的区域完全一致,否则会报找不到对应资源的错误
内容的提问来源于stack exchange,提问作者Donovan P
相关产品推荐
相关产品推荐

