分享方式:


開始使用內容 API

若要使用內容 API,您需要幾件事:

  1. Microsoft 帳戶
  2. Microsoft Advertising 帳戶
  3. 開發人員權杖

若要取得 Microsoft Advertising 帳戶,請移至 https://ads.microsoft.com 。 如果您未登入您的 Microsoft 帳戶,系統會將您重新導向以登入您的帳戶或註冊一個帳戶。 登入之後,您可以選擇 註冊新的 Microsoft Advertising 帳戶。 選取註冊選項,然後按一下 [ 繼續]

接下來,如果您還沒有適用于生產環境的 Microsoft Advertising 開發人員權杖,請移至 開發人員入口網站。 按一下 [要求權杖 ] 並提供要求的資訊。 如果您使用 API 來管理自己的帳戶,您會立即收到權杖;不過,如果您要管理其他人的帳戶,則最多可能需要五個工作天才能取得權杖。

驗證您的認證

重要事項

從 2022 年 6 月 1 日開始,所有透過使用 Bing 廣告 API、內容 API 和旅館 API 的協力廠商應用程式登入的使用者,都必須進行多重要素驗證。

您必須更新應用程式,才能使用新 msads.manage 範圍取得使用者同意。 所有應用程式開發人員都必須採取動作,才能使用新的範圍。

如需詳細資訊,請參閱 Multi-Factor Authentication 需求 指南。

內容 API 使用與 Bing 廣告 API 相同的驗證配置。 如需使用 OAuth 驗證 Microsoft 帳號憑證的詳細資訊,請參閱使用Microsoft 身分識別平臺進行驗證

您可以使用適用于 .NET、JAVA 或 Python 的Bing Ads SDK來驗證 Microsoft 帳號憑證。 如需使用 SDK 取得存取權杖的詳細資訊,請參閱C# | JAVA | Python。 如需使用 SDK 進行驗證的內容 API 範例,請參閱 管理產品範例

(請注意,Bing Ads SDK 不提供內容 API 的介面。如果您也使用適用于 Microsoft Advertising 的 SDK 行銷活動,您應該只使用 SDK 來取得存取權杖。否則,安裝 SDK.) 可能不值得額外負荷

如果您未使用 Bing Ads SDK 進行驗證,請參閱 在 C# 中驗證 Microsoft 帳號憑證 ,以取得示範如何使用 OAuth 驗證 Microsoft 帳號憑證的範例。

您的認證和開發人員權杖在何處使用?

所有呼叫都必須指定:

  • 設定為開發人員權杖的 DeveloperToken 標頭。
  • 設定為存取權杖的 AuthenticationToken 標頭。

如果您代表其他客戶管理目錄,也必須設定下列標頭:

  • 設定為您所管理市集之客戶客戶識別碼的 CustomerId 標頭
  • 設定為您管理的任何客戶帳戶之帳戶識別碼的 CustomerAccountId 標頭 (不論哪一個 Managed 帳戶) 。

如需要求和回應可能包含之這些標頭的相關資訊,請參閱 標頭

將 Microsoft 商家中心設定為使用 API

如需 Microsoft 商家中心 (MMC) 的概觀,請參閱 什麼是 Microsoft 商家中心? 本主題包含所有商家中心主題和相關影片的連結。

如果您尚未完成,則必須完成下列步驟。

  1. 確認並宣告網站的 URL 若要取得驗證並宣告網站 URL 中所述的 Webmaster 工具,請參閱 Bing Webmaster Tools。 使用您用於 Microsoft Advertising 的相同 Microsoft 帳戶登入。 如需使用此工具的詳細資訊,請參閱 驗證網站的擁有權
  2. 建立 Microsoft 商家中心商店
  3. 新增目錄

當您建立 MMC 存放區時,此程式會為您建立預設目錄。 您建立的存放區和所有目錄都會自動啟用以進行 API 管理。 商店包含預設目錄,所有產品作業預設 (新增、更新、刪除和取得) 套用。 若要指定不同的目錄,請在資源 URL 中使用 bmc-catalog-id 查詢參數。

若要新增和啟用目錄,請使用 目錄 資源。 如需詳細資訊,請 參閱管理您的目錄

注意事項

在某些情況下,您可以使用 API 和 FTP/SFTP 來更新目錄摘要。 如需搭配 FTP/SFTP 使用 API 的相關資訊,請參閱 我可以使用 API 和 FTP/SFTP 嗎?

後續步驟

現在您已準備好開始使用 API,請參閱下列各節。