Entra ID による認証
重要
2022 年 6 月に、Bing 広告の要件として 多要素認証 を導入しました。 この要件に準拠するためには、コードの変更が必要になる場合もあります。 Microsoft 広告は、10 月初旬に技術的な適用チェックを実施しています。
このブログ投稿 では、コンプライアンスを確保するために実行すべき手順の概要を説明します。
詳細については、「 多要素認証要件 ガイド」を参照してください。
注:
Microsoft Advertising API では、認証に Azure Entra ID (旧称 Azure AD) を使用します。 アプリの登録、テナント アクセス、管理者の同意、OAuth トークンの取得に関する問題が発生した場合は、Azure サポートまたはテナント管理者にお問い合わせください。
サインインするユーザー (例: example@contoso.com) を考えてみましょう。 Bing Ads API は、そのメール アドレスとパスワードを受け入れません。 代わりに、ユーザー アクセス トークンを含む AuthenticationToken ヘッダー要素を設定する必要があります。 アクセス トークンは、ユーザー名とパスワードを表すものと考えることができます。
ユーザーのアクセス トークンを取得するにはどうすればよいですか? アプリケーション開発者は、Microsoft 承認 URL を使用して Microsoft 広告ユーザーに同意を求めます。 ユーザーが同意したら、アクセス トークンを取得して、ユーザーに代わって操作できます。
Microsoft 広告は、開発者用の Microsoft ID プラットフォーム エンドポイントと OAuth 2.0 プロトコルを利用して、hotmail.com、outlook.com、msn.com などの個人の Microsoft アカウント (MSA) Azure の職場または学校アカウントを認証します。
アプリケーションが Microsoft Advertising アカウントを管理するためのユーザーの同意を要求する
ヒント
Bing Ads SDK を使用してアクセス トークンと更新トークンを取得する方法の詳細については、「 SDK での認証」を参照してください。
次の手順 (Entra ID)
Google OAuth での認証
Microsoft Advertising API では、Microsoft ID (Azure Entra ID) と共に、追加の認証オプションとして Google OAuth 2.0 がサポートされています。
- Google OAuth は、代替ではなく 代替 ID プロバイダーとして追加されます。
- Microsoft ID OAuth は引き続きサポートされ、動作は変更されません。
- Google OAuth 2.0 は、新しくサポートされた認証オプションです。
- 新しい要求ヘッダー
IdentityProviderが導入されました。 - 開発者トークンの要件は変更されません。
アプリケーションが Google アカウントを管理するためのユーザーの同意を要求します。