调用DV360 advertisers.lineItems.list接口无法获取YouTube及合作伙伴订单项

问题原因 #

你遇到的是DV360 API的资源分类隔离默认限制，YouTube & Partners 分类下的Line Item属于专属的YouTube广告资源体系，默认的接口调用只会返回Display、Video等常规广告网络的Line Item数据，查询YouTube类Line Item需要额外配置权限和请求参数。

解决方案 #

• 首先确认你的Google Cloud项目已经单独开通了DV360 API的YouTube资源访问权限，该权限和普通DV360 API调用权限分开审核，未开通的情况下默认无法访问YouTube类Line Item，调用get接口会直接返回404而非权限错误提示，这是平台的安全设计。
• 调用advertisers.lineItems.list接口时，需要添加view参数并设置为LINE_ITEM_VIEW_FULL，默认的LINE_ITEM_VIEW_BASIC参数不会返回YouTube系的资源数据；同时可以搭配filter参数指定库存源过滤规则，进一步缩小查询范围。
• 调用advertisers.lineItems.get查询指定YouTube类Line Item前，先确认你的OAuth凭证或者服务账号已经被分配了对应DV360广告主的YouTube资源查看权限，且传入的advertiserId和lineItemId完全匹配，避免因权限不匹配触发404报错。

排查建议 #

如果完成上述配置后仍然无法获取数据，可以先在DV360前端界面确认目标Line Item未被归档、删除，且归属的广告主ID和你接口传入的ID一致，同时确认你的API调用凭证的权限范围包含https://www.googleapis.com/auth/display-video的对应读写权限。

内容的提问来源于stack exchange，提问作者Nicolò Gasparini