在沙盒中测试代码
Microsoft 不提供内容 API 的沙盒,你可以在其中测试应用程序,然后再将其部署到生产环境。
但是,可以使用以下选项在生产环境中测试应用程序,而不会影响实时数据。 这些选项仅适用于产品和库存资源,不适用于目录资源。
使用试运行查询参数
若要在生产环境中测试代码,而不修改实时源并影响服务广告,请在终结点 URL 中包含 试运行 查询参数,如下所示。
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/{bmcMerchantId}/products/{itemUniqueId}?dry-run
使用 dry-run
不会更改实时源,但会返回验证错误。
由于使用试运行参数时不会将数据存储在数据库中,因此使用此选项时请考虑以下限制:
- 插入操作不会返回 ID
- 该服务不会生成并返回辅助错误消息,例如数据质量、编辑问题和数据库相关验证
请注意,Catalogs 资源不支持 dry-run
查询参数。
禁用发布
另一个选项是禁用目录发布内容的功能。 禁用的目录不会提供广告。 这允许你对目录执行操作并捕获发生的任何错误。
若要禁用 Microsoft Advertising Web 应用程序中的目录,请从“ 目录管理 ”选项卡中选择目录。然后,在“ 目录设置 ”选项卡上,取消选择 “启用发布”。
还可以使用 目录 资源来禁用发布。 有关详细信息,请参阅 管理目录。
与使用 dry-run
查询参数一样,不会生成辅助错误消息,例如数据质量、编辑问题和数据库相关验证,也不会返回。 但是,插入操作将返回 ID。
警告
产品在商店中是唯一的,而不是目录。 如果在多个目录中具有相同 ID 的产品,则对禁用目录中的产品所做的任何更改也会在启用的目录中发生。 这意味着,即使一个目录中禁用了发布,另一个目录也可能为该产品提供广告。
注意
不能更新商店的默认目录。 如果尝试更新默认目录,请求将失败。