You need to enable JavaScript to run this app. Google Drive Watch API 如何配置Webhook通知的请求头与请求体
优惠活动
大模型
产品
解决方案
定价
更多

Google Drive Watch API 如何配置Webhook通知的请求头与请求体

关于Google Drive v3 API files.watch 接口Webhook鉴权配置说明

自定义请求头、请求体的配置限制

  • files.watch 接口注册通知通道时,可配置的 Channel 资源字段均为Google官方定义的固定枚举字段,没有预留自定义请求头、自定义请求体的扩展配置项,因此无法在注册环节直接指定给Webhook推送通知添加额外的自定义鉴权头、请求体参数。

可实现鉴权校验的官方内置方案

无需自定义请求头/体即可完成通知合法性校验,Google为推送通知提供了多个内置的可自定义或可校验的标识字段:

  • 自定义通道令牌字段 token
    注册 files.watch 通知通道时,可在 Channel 配置中传入任意符合长度限制的自定义字符串作为 token 值,该值会被原样添加到每次推送通知的 X-Goog-Channel-Token 请求头中。你可以将自定义鉴权密钥设置为这个token的值,Webhook收到通知后校验该请求头的值是否与预设密钥匹配,即可实现基础鉴权效果。
  • 通道与资源ID校验
    注册通知通道成功后,接口会返回专属的 channelId 与对应监听资源的 resourceId,每次推送通知都会携带 X-Goog-Channel-ID、X-Goog-Resource-ID 请求头,Webhook端可校验这两个值是否为自身合法注册过的通道对应ID,拦截伪造请求。
  • 官方数字签名校验
    所有Google发起的推送通知都会携带 X-Goog-Signature 请求头,该值是Google使用你在Google Cloud Console中配置的密钥对请求体计算的HMAC-SHA256签名,Webhook端可使用相同密钥完成验签,这是安全性最高的校验方式。

补充说明

  • 自定义 token 字段支持传入任意符合官方限制的字符串,完全可以满足存储自定义鉴权令牌的需求,不需要额外配置自定义请求头。

内容的提问来源于stack exchange,提问作者yuhr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 13:24:00