開始使用內容 API
- Microsoft 帳戶
- Microsoft Advertising 帳戶
- 開發人員權杖
若要取得 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 商家中心? 本主題包含所有商家中心主題和相關影片的連結。
如果您尚未完成,則必須完成下列步驟。
- 確認並宣告網站的 URL 若要取得驗證並宣告網站 URL 中所述的 Webmaster 工具,請參閱 Bing Webmaster Tools。 使用您用於 Microsoft Advertising 的相同 Microsoft 帳戶登入。 如需使用此工具的詳細資訊,請參閱 驗證網站的擁有權。
- 建立 Microsoft 商家中心商店
- 新增目錄
當您建立 MMC 存放區時,此程式會為您建立預設目錄。 您建立的存放區和所有目錄都會自動啟用以進行 API 管理。 商店包含預設目錄,所有產品作業預設 (新增、更新、刪除和取得) 套用。 若要指定不同的目錄,請在資源 URL 中使用 bmc-catalog-id 查詢參數。
若要新增和啟用目錄,請使用 目錄 資源。 如需詳細資訊,請 參閱管理您的目錄。
注意事項
在某些情況下,您可以使用 API 和 FTP/SFTP 來更新目錄摘要。 如需搭配 FTP/SFTP 使用 API 的相關資訊,請參閱 我可以使用 API 和 FTP/SFTP 嗎?
後續步驟
現在您已準備好開始使用 API,請參閱下列各節。