OAuth Playground

One option for generating OAuth2 credentials is to use the OAuth2 Playground. The OAuth2 Playground, in conjunction with the Google Ads API console, lets you manually create OAuth2 tokens.

The OAuth2 Playground is for users who only need to access the accounts for a single manager account or Google Ads user. If you need to prompt multiple users for credentials, it is likely better to configure a client library for OAuth in Search Ads 360.

Get a client ID and client secret

If you do not have an existing cloud project:

1. Open the Google API Console Credentials page .

2. From the project drop-down, select an existing project or create a new one.

3. On the Credentials page, select Create credentials, then select OAuth client ID.

4. Under Application type, choose Web application.

5. Under Authorized redirect URIs, add a line with: https://developers.google.com/oauthplayground

6. Click Create.

7. On the Client ID page, take note of the client IDand client secret. You'll need these in the next step.

If you have an existing cloud project, you can reuse it by setting the Authorized redirect URIs as above.

Generate tokens

1. Go to the OAuth2 Playground , (using this link should pre-populate some key values for you).

2. Click the gear iconin the upper right corner and check the box labeled Use your own OAuth credentials(if it isn't already checked).

3. Make sure that:

   • OAuth flowis set to Server-side.
   • Access typeis set to Offline(this ensures you get a refresh token and an access token, instead of just an access token).

4. Enter the OAuth2 client IDand OAuth2 client secretyou obtained above.

   

5. In the section labeled Step 1 - Select & authorize APIs, click Search Ads 360 Reporting APIfrom the list and select its scope, https://www.googleapis.com/auth/doubleclicksearch . Then click Authorize APIs:

   

6. If prompted, sign in to the account to which you want to grant access and authorization. Otherwise, confirm that the current user in the top right corner is the client or manager account for whom you want to obtain credentials.

   • Publish the app.

   • Keep the app in the Testing status, and add yourself as a test user.

7. A prompt appears indicating your app would like to Manage your Search Ads 360 campaigns. Click Acceptto continue.

8. In the tab labeled Step 2 - Exchange authorization code for tokens, an Authorization codeshould appear. Click Exchange authorization code for tokens.

   

9. If all goes well, the Refresh tokenand Access tokenshould be filled in for you (you may have to re-expand Step 2 - Exchange authorization code for tokens):

   

10. Copy the Refresh tokeninto the configuration file for your client library of choice, along with the client IDand client secret.

11. Configure a client library for OAuth in the Search Ads 360 Reporting API .

Remove the OAuth2 Playground from your client ID

Now that you have a refresh token, you no longer need the OAuth2 Playground to be an authorized redirect URI. To remove it from the list of authorized redirect URIs:

1. Go to the Google API Console Credentials page .

2. From the project drop-down, select your project.

3. On the Credentials page, click the client ID nameto edit.

4. Remove https://developers.google.com/oauthplayground from the Authorized redirect URIs. Note that you must leave at least one redirect URI in place.

5. Click Save.