管理您的目錄
內容 API 是一種 RESTful API，會使用 目錄 資源來管理 Microsoft 商家中心 (MMC) 存放區中的目錄。
以下是您用來呼叫內容 API 的基底 URI。
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/
每個 HTTP 要求都必須包含使用者的 OAuth 存取權杖和您的開發人員權杖。 若要指定使用者的存取權杖，請設定 AuthenticationToken 標頭。 若要指定您的開發人員權杖，請設定 DeveloperToken 標頭。
如果您代表其他客戶管理目錄，您必須設定：
- 客戶識別碼的 CustomerId標頭，是您所管理之商店的客戶識別碼。
- 您管理的任何客戶帳戶之帳戶識別碼的 CustomerAccountId 標頭 (不論哪一個 Managed 帳戶) 。
根據預設，內容 API 會使用 JSON 物件來表示目錄。 若要使用 XML，請將 alt 查詢參數設定為 XML。
如需使用目錄資源的詳細資訊，請參閱下列各節。
如需示範如何取得、新增、更新和刪除目錄的程式碼範例，請參閱 管理目錄程式碼範例。
從市集取得目錄
若要從市集取得目錄，請將下列範本附加至基底 URI。
{bmcMerchantId}/catalogs/{catalogId}
設定 {bmcMerchantId} 為您的 MMC 存放區識別碼，並設定 {catalogId} 為目錄的 識別碼。
將 HTTP GET 要求傳送至產生的 URL。 如果找到目錄，回應會包含包含目錄詳細資料的 Catalog 物件。
從市集取得目錄清單
若要從市集取得目錄清單，請將下列範本附加至基底 URI。
{bmcMerchantId}/catalogs
設定 {bmcMerchantId} 為您的 MMC 存放區識別碼。
將 HTTP GET 要求傳送至產生的 URL。 如果存放區包含目錄，回應會包含包含目錄清單的 Catalogs 物件。
從存放區刪除目錄
若要從市集刪除目錄，請將下列範本附加至基底 URI。
{bmcMerchantId}/catalogs/{catalogId}
設定 {bmcMerchantId} 為您的 MMC 存放區識別碼，並設定 {catalogId} 為目錄的 識別碼。
將 HTTP DELETE 要求傳送至產生的 URL。 如果找到目錄，則會將其刪除。
將目錄新增至存放區
您可以使用目錄，以邏輯方式將產品分組。 若要將目錄新增至市集，請將下列範本附加至基底 URI。
{bmcMerchantId}/catalogs
設定 {bmcMerchantId} 為您的 MMC 存放區識別碼。
將 HTTP POST 要求傳送至產生的 URL。 如果新增目錄，回應會包含 Catalog 物件。 物件 Catalog 包含目錄的 識別碼。 使用識別碼來取得和刪除目錄。
要求的本文是 Catalog 物件。 您必須指定下欄欄位。
您指定的名稱在存放區中必須是唯一的，且上限為 70 個字元。 市場會識別產品提供服務的位置。 如需支援的市場清單，請參閱 市場。 只有當 為true時 isPublishingEnabled ，才會提供產品。 如需如何使用 isPublishingEnabled 測試應用程式的詳細資訊，請參閱 在沙箱中測試程式碼。
更新存放區中的目錄
若要更新市集中的目錄，請將下列範本附加至基底 URI。
{bmcMerchantId}/catalogs/{catalogId}
設定 {bmcMerchantId} 為您的 MMC 存放區識別碼，並設定 {catalogId} 為目錄的 識別碼。
要求的本文是 Catalog 物件。 您必須指定下欄欄位。
將 HTTP PUT 要求傳送至產生的 URL。 如果目錄已更新，回應會包含已更新的 Catalog 物件。