使用Google Analytics Admin API批量创建媒体资源及自定义维度时随机触发权限异常

问题描述 #

我正在使用Google Analytics Admin API创建媒体资源，通过循环批量创建媒体资源与自定义维度，但在成功创建3至20个资源后，会触发如下权限错误：

Exception creating property for 305890164: {
    "message": "The caller does not have permission",
    "code": 7,
    "status": "PERMISSION_DENIED",
    "details": []
}

该错误发生在为刚创建的媒体资源添加自定义维度时，无法理解为何会在随机数量的资源创建成功后才触发此问题，恳请提供排查思路。另外，部分代码从Alpha阶段进入Beta阶段值得肯定，但推进速度实在太慢了。

排查思路 #

• 资源权限同步延迟：GA媒体资源创建后，权限系统可能存在几秒到几十秒的同步延迟，刚创建就立即添加自定义维度，可能遇到服务端权限校验未完成的情况。建议在创建资源后加入1-3秒的等待，或者通过properties.get接口轮询资源状态，确认权限生效后再执行维度操作。
• 隐性速率限制触发：虽然错误提示是权限问题，但高频批量调用API可能触发Google的隐性速率限制，服务端会以权限错误作为兜底响应。检查Google Cloud控制台的API配额使用情况，确保未超出限制；同时在循环中加入请求间隔，或实现指数退避策略。
• 服务账号权限继承问题：确认所使用的服务账号是否拥有新创建媒体资源的编辑权限。部分场景下，批量创建的资源可能未正确继承服务账号的权限，可手动查看失败资源的权限列表，验证服务账号是否在权限组内。
• 身份凭据有效性：循环调用过程中，OAuth2令牌可能过期失效。检查代码中是否实现了令牌自动刷新逻辑，确保每次请求都使用有效的身份凭据。
• Beta版本API稳定性：若使用的是Beta版Admin API，可能存在批量操作的权限校验bug。尝试切换到稳定版API，或查阅官方文档的已知问题列表，确认是否有相关问题记录。

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