承認を設定する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Search Ads 360 API では、すべてのリクエストで認証用の OAuth 2.0 アクセス トークンを指定する必要があります。標準の OAuth 2.0 認証ワークフローに沿ってトークンを生成し、Search Ads 360 API に渡すことができます。以下のワークフローは、完全に自動化されたコンバージョンのアップロードとレポートのダウンロードに適しているため、おすすめです。
以下で説明するワークフローの代わりに、インストール済みアプリケーションに OAuth 2.0 を使用するまたは
サーバー間アプリケーションに OAuth 2.0 を使用するをご覧ください。別のワークフローを使用する場合は、OAuth 2.0 認可コードをリクエストするときに、scope パラメータとして次の値を指定します。
https://www.googleapis.com/auth/doubleclicksearch
サーバー間ルートを使用する場合は、サービス アカウントを Search Ads 360 ユーザーとして追加します。
推奨される承認ワークフロー
- Google API Console に移動し、プロジェクトを選択します。
Google API Console プロジェクトと OAuth 認証情報をまだ作成していない場合は、クライアントの Google API Console プロジェクトと OAuth 認証情報を作成するの手順に沿って作成します。
プロジェクトの OAuth クライアント ID とシークレットを確認するには、次の操作を行います。
- [認証情報] ページを開きます。
- [名前] 列で、OAuth クライアントの名前をクリックします。
- クライアント ID とシークレットがページに表示されます。
- ウェブブラウザを開き、検索広告 360 のデータにアクセスする権限がある Google アカウントで Google にログイン
します。
これは、API クライアントが検索広告 360 の認証に使用する Google アカウントです。Google アカウントの所有者が退職し、アカウントから検索広告 360 のアクセス権を削除した場合は、この承認ワークフローを繰り返して、別の Google アカウントを指定する必要があります。
- 次のように 検索広告 360 ユーティリティ スクリプトを呼び出して、更新トークンを取得します。
sa360Api.py --login
このスクリプトでは、Oauth クライアント ID とシークレットを使用して更新トークンを取得するプロセスについて説明します。更新トークンは、前の手順でログインした Google アカウントでのみ有効です。
このプロセスの一環として、スクリプトによって URL が生成され、ウェブブラウザで URL にアクセスするように指示されます。
-
ブラウザで、OAuth クライアントによる検索広告 360 データへのアクセスを許可するよう求められたら、先ほどログインした Google アカウントが表示されていることを確認します。（複数の Google アカウントにログインしている場合は、別のアカウントが表示されることがあります）。
プロセスの終了時に、sa360Api.py スクリプトはカンマ区切りの文字列を出力します。最初の値は指定したクライアント ID、2 番目の値は指定したクライアント シークレット、3 番目の値は更新トークンです。次の出力例では、更新トークンが太字で示されています。
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
- クライアント ID、クライアント シークレット、更新トークンを、バックエンド データベースまたはアプリケーションがアクセスできる安全な場所に保存します。
sa360Api.py を使用して検索広告 360 API にサンプル JSON リクエストを送信する場合は、カンマ区切りの文字列全体を便利な場所に保存しておいてください。スクリプトを呼び出すたびに、文字列全体をパラメータとして渡します。
- 次の処理を行うコードをアプリケーションに追加します。
- クライアント ID、クライアント シークレット、更新トークンを使用して、新しい OAuth 2.0 アクセス トークンを取得します。
- 新しいアクセス トークンを使用して、Search Ads 360 API にリクエストを送信します。
クライアント ライブラリを使用している場合は、次のセクションのアプリケーションを設定するで、この認可コードをアプリケーションに追加する方法について説明します。
いずれのクライアント ライブラリも使用していない場合は、インストール済みアプリケーションに OAuth 2.0 を使用するで、新しいアクセス トークンを取得する方法をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-11-07 UTC。
[null,null,["最終更新日 2024-11-07 UTC。"],[[["\u003cp\u003eThe Search Ads 360 API requires OAuth 2.0 access tokens for authentication, obtainable through standard OAuth 2.0 workflows or the recommended workflow outlined in the document.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended workflow involves obtaining a refresh token using the provided utility script and storing it securely along with the client ID and secret.\u003c/p\u003e\n"],["\u003cp\u003eApplications should be designed to use the stored credentials to obtain fresh access tokens for API requests, as detailed in the "Set Up Your Application" section or relevant OAuth 2.0 documentation.\u003c/p\u003e\n"],["\u003cp\u003eAlternative workflows for installed or server-to-server applications are available with specific scope requirements and user management considerations.\u003c/p\u003e\n"]]],["The Search Ads 360 API requires OAuth 2.0 access tokens for authentication. The recommended workflow involves creating a Google API Console project and obtaining OAuth credentials. Users sign into a Google Account with Search Ads 360 access, then use the `sa360Api.py` script to generate a refresh token. The script outputs client ID, client secret, and refresh token. Store these securely, and use them in your application to obtain a fresh OAuth access token for API requests.\n"],null,["# Set Up Authorization\n\nThe Search Ads 360 API requires all requests to specify an [OAuth 2.0](/accounts/docs/OAuth2)\naccess token for authentication. You can follow any standard OAuth 2.0 authentication workflow\nto generate the token and pass it to the Search Ads 360 API. We recommend the workflow described\nbelow because it is suitable for fully automated conversion uploads and report downloads.\n\n\nFor alternatives to the workflow described below, see [Using\nOAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) or\n[Using OAuth 2.0 for Server to Server Applications](https://developers.google.com/identity/protocols/OAuth2ServiceAccount). If you use an alternate workflow,\nspecify the following value as the `scope` parameter when you request an OAuth\n2.0 authorization code: \n\n`https://www.googleapis.com/auth/doubleclicksearch`\n\nIf you follow the server to server route, add the service account as a Search Ads 360 user.\n\nRecommended authorization workflow\n----------------------------------\n\n1. Go to the [Google API Console](https://console.cloud.google.com/) and select your project.\n\n\n If you haven't already created a Google API Console project and OAuth credentials, follow\n the instructions in [Create a Google API\n Console project and OAuth credentials for your client](/search-ads/v2/prereqs#project).\n\n To find your project's OAuth client ID and secret, do the following:\n 1. Open the [Credentials page](https://console.cloud.google.com/apis/credentials).\n 2. In the **Name** column, click the name of your OAuth client.\n 3. The client ID and secret are listed on the page.\n2. Open a web browser and [sign into Google](https://accounts.google.com/ServiceLogin)with a Google Account that [has\n permission to access data](/search-ads/v2/prereqs#permissions) in Search Ads 360.\n\n This is the Google Account your API client will use to authenticate with Search Ads 360.\n If the Google Account holder leaves your company and you remove Search Ads 360 access\n from the account, you will need to repeat this authorization workflow and specify a\n different Google Account.\n3. Obtain a refresh token by invoking the [Search Ads 360 utility script](/search-ads/v2/prereqs#ds3py) as follows:\n\n\n `sa360Api.py --login`\n\n\n The script takes you through the process of using the Oauth client ID and secret to\n obtain a refresh token. The refresh token is valid only for the Google Account you signed\n into during the previous step.\n\n As part of this process, the script generates a URL and instructs you to\n visit the URL in a web browser.\n4. When the browser asks you to allow OAuth client access to Search Ads 360 data,\n make sure the Google Account you signed into earlier appears. (If you're signed into multiple\n Google Accounts, you might be presented with a different account.)\n\n\n At the end of the process, the `sa360Api.py` script outputs a comma-delimited\n string. The first value is the client ID you provided, the second value is the client\n secret you provided, and the third value is the refresh token. In the following example\n output, the refresh token is in **bold text** : \n\n `123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,`**1/HIJklM01OPQR23NOP456rst890uvw**\n5. Store the client ID, client secret, and refresh token in a backend database or other secure location that's accessible to your application.\n Keep the entire comma-delimited string in a convenient location if you plan to use\n `sa360Api.py` to send sample JSON requests to the Search Ads 360 API. You'll pass the\n entire string as a parameter each time you invoke the script.\n\n6. Add code to your application that does the following:\n 1. Use the client ID, client secret, and refresh token to obtain a fresh OAuth 2.0 access token.\n 2. Send requests to the Search Ads 360 API using the fresh access token.\n\n\n If you're using the client libraries, the next section, [Set Up Your Application](/search-ads/v2/configure),\n describes how to add this authorization code to your application.\n\n\n If you're not using one of the client libraries, see [Using OAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) for\n suggestions on obtaining a fresh access token."]]
