Content API の概要
Content API を使用するには、次のものが必要です。
- Microsoft アカウント
- Microsoft Advertising アカウント
- 開発者トークン
Microsoft Advertising アカウントを取得するには、 に移動します https://ads.microsoft.com。 Microsoft アカウントにサインインしていない場合は、アカウントにサインインするか、アカウントにサインアップするようにリダイレクトされます。 サインイン後、 新しい Microsoft Advertising アカウントにサインアップするオプションがあります。 サインアップ オプションを選択し、[ 続行] をクリックします。
次に、運用環境用の Microsoft Advertising 開発者トークンがまだない場合は、 開発者ポータルに移動します。 [ 要求トークン ] をクリックし、要求された情報を指定します。 API を使用して独自のアカウントを管理する場合は、すぐにトークンを受け取ります。ただし、他のユーザーのアカウントを管理している場合は、トークンを取得するのに最大 5 営業日かかることがあります。
資格情報の認証
重要
2022 年 6 月 1 日より、Bing Ads API、Content API、および Hotel API を使用するサードパーティ アプリケーションを介してサインインするすべてのユーザーに多要素認証が必要になります。
新しいmsads.manageスコープを使用してユーザーの同意を得るには、アプリケーションを更新する必要があります。 すべてのアプリケーション開発者は、新しいスコープを使用するためにアクションを実行する必要があります。
詳細については、「 多要素認証要件 ガイド」を参照してください。
Content API では、Bing Ads API と同じ認証スキームが使用されます。 OAuth を使用した Microsoft アカウント資格情報の認証の詳細については、「 Microsoft ID プラットフォームを使用した認証」を参照してください。
Bing Ads SDK for .NET、Java、または Python を使用して、Microsoft アカウントの資格情報を認証できます。 SDK を使用してアクセス トークンを取得する方法の詳細については、「 C# | Java | Python」を参照してください。 認証に SDK を使用する Content API の例については、「 製品の管理の例」を参照してください。
(Bing Ads SDK には Content API 用のインターフェイスが用意されていないことに注意してください。SDK for Microsoft Advertising キャンペーンを使用している場合にのみ、SDK を使用してアクセス トークンを取得する必要があります。それ以外の場合は、SDK をインストールするオーバーヘッドの価値がない可能性があります)。
認証に Bing Ads SDK を使用しない場合は、OAuth を使用して Microsoft アカウントの資格情報を認証する 方法を示す例については、「C# での Microsoft アカウント資格情報の認証」を参照してください。
資格情報と開発者トークンを使用する場所
すべての呼び出しで次を指定する必要があります。
- 開発者トークンに設定されている DeveloperToken ヘッダー。
- アクセス トークンに設定されている AuthenticationToken ヘッダー。
他の顧客に代わってカタログを管理する場合は、次のヘッダーも設定する必要があります。
- 管理しているストアを持つ顧客の顧客 ID に設定されている CustomerId ヘッダー
- 管理する顧客のアカウントのアカウント ID に設定されている CustomerAccountId ヘッダー (管理対象アカウントは関係ありません)。
これらのヘッダーと、要求と応答に含まれる可能性があるその他のヘッダーについては、「 ヘッダー」を参照してください。
API を使用するように Microsoft Merchant Center を構成する
Microsoft Merchant Center (MMC) の概要については、「 Microsoft Merchant Center とは 」を参照してください。このトピックには、Merchant Center のすべてのトピックと関連するビデオへのリンクが含まれています。
まだ実行していない場合は、次の手順を完了する必要があります。
- Web サイトの URL を確認して要求 する「Web サイトの URL を確認して要求する」に記載されている Web マスター ツールを取得するには、「 webmaster ツールのBing」を参照してください。 Microsoft Advertising に使用するのと同じ Microsoft アカウントでサインインします。 ツールの使用方法の詳細については、「 Web サイトの所有権を確認する」を参照してください。
- Microsoft Merchant Center ストアを作成する
- カタログを追加する
MMC ストアを作成すると、プロセスによって既定のカタログが自動的に作成されます。 ストアと作成したすべてのカタログは、API 管理に対して自動的に有効になります。 ストアには、すべての製品操作 (追加、更新、削除、取得) が既定で適用される既定のカタログが含まれています。 別のカタログを指定するには、リソース URL で bmc-catalog-id クエリ パラメーターを使用します。
カタログを追加して有効にするには、 Catalogs リソースを使用します。 詳細については、「 カタログの管理」を参照してください。
注:
特定の状況では、API と FTP/SFTP を使用してカタログ フィードを更新できます。 FTP/SFTP で API を使用する方法については、「API と FTP/SFTP を使用できますか」を参照してください。
次の手順
API の使用を開始する準備ができたので、次のセクションを参照してください。