管理目录

内容 API 是一种 RESTful API，它使用 目录 资源来管理 Microsoft 商家中心 (MMC) 商店中的目录。

下面是用于调用内容 API 的基 URI。

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

每个 HTTP 请求都必须包含用户的 OAuth 访问令牌和开发人员令牌。 若要指定用户的访问令牌，请设置 AuthenticationToken 标头。 若要指定开发人员令牌，请设置 DeveloperToken 标头。

如果代表其他客户管理目录，则必须设置：

• 要管理其商店的客户的客户 ID 的 CustomerId 标头。
• 你管理的任何客户帐户的帐户 ID 的 CustomerAccountId 标头 (与哪个托管帐户) 无关紧要。

默认情况下，内容 API 使用 JSON 对象来表示目录。 若要使用 XML，请将 alt 查询参数设置为 XML。

有关使用目录资源的详细信息，请参阅以下部分。

• 从应用商店获取目录
• 从应用商店中获取目录列表
• 从存储区中删除目录
• 将目录添加到应用商店
• 更新应用商店中的目录

有关演示如何获取、添加、更新和删除目录的代码示例，请参阅 管理目录代码示例。

从应用商店获取目录

若要从存储区获取目录，请将以下模板追加到基 URI。

{bmcMerchantId}/catalogs/{catalogId}

将 设置为 {bmcMerchantId} MMC 存储 ID，并设置为 {catalogId} 目录的 ID。

将 HTTP GET 请求发送到生成的 URL。 如果找到目录，响应将包含目录详细信息的 Catalog 对象。

从应用商店中获取目录列表

若要从存储区获取目录列表，请将以下模板追加到基 URI。

{bmcMerchantId}/catalogs

将 设置为 {bmcMerchantId} MMC 存储 ID。

将 HTTP GET 请求发送到生成的 URL。 如果存储区包含目录，则响应将包含目录列表的 Catalogs 对象。

从存储区中删除目录

若要从存储区中删除目录，请将以下模板追加到基 URI。

{bmcMerchantId}/catalogs/{catalogId}

将 设置为 {bmcMerchantId} MMC 存储 ID，并设置为 {catalogId} 目录的 ID。

将 HTTP DELETE 请求发送到生成的 URL。 如果找到目录，则会将其删除。

将目录添加到应用商店

使用目录对产品进行逻辑分组。 若要将目录添加到存储区，请将以下模板追加到基 URI。

{bmcMerchantId}/catalogs

将 设置为 {bmcMerchantId} MMC 存储 ID。

将 HTTP POST 请求发送到生成的 URL。 如果添加了目录，则响应将包含 Catalog 对象。 对象 Catalog 包括目录的 ID。 使用 ID 获取和删除目录。

请求的正文是 Catalog 对象。 必须指定以下字段。

• 名称
• 市场
• isPublishingEnabled

指定的名称在存储中必须唯一，并且最多只能包含 70 个字符。 市场确定产品的供应位置。 有关受支持市场的列表，请参阅 市场。 仅当为 true 时isPublishingEnabled，才会提供产品。 有关如何用于 isPublishingEnabled 测试应用的详细信息，请参阅 在沙盒中测试代码。

更新应用商店中的目录

若要更新存储中的目录，请将以下模板追加到基 URI。

{bmcMerchantId}/catalogs/{catalogId}

将 设置为 {bmcMerchantId} MMC 存储 ID，并设置为 {catalogId} 目录的 ID。

请求的正文是 Catalog 对象。 必须指定以下字段。

• 名称
• isPublishingEnabled

将 HTTP PUT 请求发送到生成的 URL。 如果目录已更新，响应将包含更新的 Catalog 对象。