コンテンツ API の使用を開始する

Content API を使用するには、次のいくつかのことが必要です。

  1. Microsoft アカウント
  2. Microsoft 広告アカウント
  3. 開発者トークン

Microsoft 広告アカウントを取得するには、 https://ads.microsoft.com に移動します。 Microsoft アカウントにまだサインインしていない場合は、アカウントにサインインするか、アカウントにサインアップするようにリダイレクトされます。 サインインすると、 新しい Microsoft Advertising アカウントにサインアップするオプションが表示されます。 サインアップ オプションを選択し、[ 続行] をクリックします。

次に、運用環境用の Microsoft 広告開発者トークンがまだない場合は、 開発者ポータルに移動します。 [ 要求トークン ] をクリックし、要求された情報を入力します。 API を使用して自分のアカウントを管理する場合は、トークンをすぐに受け取ります。ただし、他のユーザーのアカウントを管理している場合は、トークンを取得するまでに最大 5 営業日かかる場合があります。

資格情報の認証

重要

2022 年 6 月 1 日より、Bing Ads API、コンテンツ API、ホテル API を使用するサード パーティ製アプリケーションを介してサインインするすべてのユーザーに多要素認証が必要になります。

新しいmsads.manage スコープを使用してユーザーの同意を得るには、アプリケーションを更新する必要があります。 すべてのアプリケーション開発者は、新しいスコープを使用するためのアクションを実行する必要があります。

詳細については、「 多要素認証要件 ガイド」を参照してください。

コンテンツ API は、Bing Ads API と同じ認証スキームを使用します。 OAuth を使用した Microsoft アカウント資格情報の認証の詳細については、「Microsoft ID プラットフォームでの認証」を参照してください。

Microsoft アカウントの資格情報の認証には、.NET、Java、または Python 用の Bing Ads SDKを使用できます。 SDK を使用してアクセス トークンを取得する方法の詳細については、「 C# | Java | Python 」を参照してください。 認証に SDK を使用するコンテンツ API の例については、「 製品の管理の例」を参照してください。

(Bing Ads SDK にはコンテンツ API 用のインターフェイスが用意されていないことに注意してください。Microsoft Advertising キャンペーンにも SDK を使用している場合にのみ、アクセス トークンの取得に SDK を使用する必要があります。それ以外の場合は、SDK をインストールするオーバーヘッドに見合う価値がない可能性があります)。

認証に Bing Ads SDK を使用しない場合は、OAuth を使用して Microsoft アカウントの資格情報を認証する方法を示す例については、「 C# での Microsoft アカウントの資格情報の認証 」を参照してください。

資格情報と開発者トークンはどこで使用できますか?

すべての呼び出しで以下を指定する必要があります。

  • 開発者トークンに設定された DeveloperToken ヘッダー。
  • アクセス トークンに設定されている AuthenticationToken ヘッダー。

他の顧客に代わってカタログを管理する場合は、次のヘッダーも設定する必要があります。

  • 管理している店舗の顧客の顧客 ID に設定された CustomerId ヘッダー
  • 管理する顧客のアカウントのアカウント ID に設定された CustomerAccountId ヘッダー (管理対象アカウントは関係ありません)。

要求と応答に含まれる可能性のあるこれらのヘッダーおよびその他のヘッダーの詳細については、「 ヘッダー」を参照してください。

API を使用するための Microsoft マーチャント センターの構成

Microsoft マーチャント センター (MMC) の概要については、「 Microsoft マーチャント センターとは」を参照してください。 このトピックには、Merchant Center のすべてのトピックと関連ビデオへのリンクが含まれています。

まだ完了していない場合は、次の手順を完了する必要があります。

  1. Web サイトの URL の所有権を確認して申請 する「Web サイトの URL の確認と申請」に記載されている Web マスター ツールを取得するには、「 Bing Web マスター ツール」を参照してください。 Microsoft 広告に使用するのと同じ Microsoft アカウントでサインインします。 ツールの使用方法の詳細については、「 Web サイトの所有権を確認する」を参照してください。
  2. Microsoft マーチャント センター ストアを作成する
  3. カタログを追加する

MMC ストアを作成すると、既定のカタログが作成されます。 ストアと作成したすべてのカタログは、API Management に対して自動的に有効になります。 ストアには、すべての製品操作 (追加、更新、削除、取得) が既定で適用される既定のカタログが含まれています。 別のカタログを指定するには、リソース URL で bmc-catalog-id クエリ パラメーターを使用します。

カタログを追加して有効にするには、 カタログ リソースを使用します。 詳細については、「 カタログの管理」を参照してください。

注:

特定の状況では、API と FTP/SFTP を使用してカタログ フィードを更新できます。 FTP/SFTP で API を使用する方法については、「API と FTP/SFTP を使用できますか?」を参照してください。

次の手順

API の使用を開始する準備ができたので、次のセクションを参照してください。

  • 最終更新: