Google Storage上传API创建对象后未返回且未添加自定义元数据

• 检查上传请求的uploadType参数
  你调用的URLhttps://storage.googleapis.com/upload/storage/v1/b/my-bucket/o?name=object-name缺少uploadType参数，不同上传类型对元数据的处理逻辑不同：

  • 若为直接上传文件内容的简单上传，需添加uploadType=media，此时x-goog-meta-*请求头会被正常识别。
  • 若需同时上传元数据与文件，使用uploadType=multipart，这种场景下既可以通过x-goog-meta-*请求头设置元数据，也能在请求的JSON格式metadata部分定义。

• 确认请求头格式合规
  自定义元数据头必须严格遵循x-goog-meta-<KEY>格式，比如要设置键为custom-tag的元数据，请求头需写为：

  x-goog-meta-custom-tag: my-tag-value
  

  注意不要漏写前缀，键名尽量避免空格或特殊符号。

• 调整响应返回字段
  上传API默认不会返回全部元数据，若想在响应中看到自定义元数据，需在URL中添加fields参数，示例：

  https://storage.googleapis.com/upload/storage/v1/b/my-bucket/o?name=object-name&uploadType=media&fields=*
  

  也可指定只返回自定义元数据：fields=metadata/x-goog-meta-*

• 表单数据上传的特殊处理
  如果你在Postman中使用multipart/form-data格式上传：

  • 需将文件与元数据分开放置：一个字段存文件内容，另一个命名为metadata的字段存放JSON格式的元数据（包含自定义项），示例：

    {"metadata": {"x-goog-meta-custom-key": "custom-value"}}
    

  • 这种场景下x-goog-meta-*请求头可能不生效，建议直接在metadata字段中定义。

• 验证权限配置
  确保请求使用的身份凭证（API密钥、OAuth令牌等）拥有storage.objects.create权限，权限不足时可能会出现对象创建成功但元数据被忽略的情况。

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