このガイドでは、ユーザー認証を使用して Google Ads API にアクセスする方法について説明します。さまざまな認証オプションについて詳しくは、概要ガイドをご覧ください。
ユーザー認証ワークフローでは、OAuth 2.0 フローを使用してユーザーの承認を取得し、アプリがユーザーに代わって Google 広告アカウントを管理できるようにします。OAuth 2.0 アクセス トークンは、承認プロセスが完了すると発行されます。アプリはこのアクセス トークンを使用して、ユーザーの Google 広告アカウントに API 呼び出しを行うことができます。OAuth 2.0 アクセス トークンは 1 時間ごとに期限切れになるため、アプリがユーザーの操作なしで認証を更新できるように、OAuth 2.0 オフライン アクセスもリクエストするのが一般的です。
ユーザー認証ワークフローを構築するには、シングル ユーザー認証とマルチユーザー認証の 2 つの一般的な方法があります。単一ユーザー認証は、サービス アカウント ワークフローのフォールバックとして使用されます。これは、単一のユーザーが Google 広告 API を使用して管理する必要があるすべての Google 広告アカウントにアクセスできる場合に使用されます。一方、マルチユーザー認証は、複数のユーザーが管理するアカウントを管理する必要があり、ユーザーを認証するための独自の OAuth フローを構築する必要がある場合に使用されます。