Get an OAuth2 Refresh Token and Configure Your Client

Because OAuth2 access expires after a limited time, an OAuth2 refresh token is used to automatically renew OAuth2 access.

Click the tab for the programming language you're using, and follow the instructions to generate an OAuth2 refresh token and set up the configuration file for your client.

Java

Learn how to get a refresh token.

Return to this page when you're done. After completing the steps, your ads.properties file should have all you need to make test API calls, and should contain values similar to the following:

...
api.googleads.developerToken=123axxxxxxxxxxxxxxxxxx
api.googleads.clientId=xxxxxxxxxx.apps.googleusercontent.com
api.googleads.clientSecret=zZxxxxxTxxxxxxxxxxx
api.googleads.refreshToken=1/dyOIp7ki-xxxxxxxxxxxxxxxxxxxxxxxx
...

C#

Learn how to get a refresh token.

Return to this page when you're done. After completing the steps, your app.config file should have all you need to make test API calls, and should contain values similar to the following:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="GoogleAdsApi"
        type="System.Configuration.DictionarySectionHandler"/>
  </configSections>
  <GoogleAdsApi>
    <!-- Settings specific to Google Ads API.-->
    <add key="DeveloperToken" value="xxxxxxxxxxxxxxxxxxxxxx"/>

    <!-- OAuth2 configuration -->
    <add key="AuthorizationMethod" value="OAuth2" />
    <add key="OAuth2ClientId" value="xxxxxxxxxx.apps.googleusercontent.com" />
    <add key="OAuth2ClientSecret" value="zZxxxxxTxxxxxxxxxxx" />
    <add key="OAuth2Mode" value="APPLICATION" />
    <add key="OAuth2RefreshToken" value="1/dyOIp7ki-xxxxxxxxxxxxxxxxxxxxx" />
  </GoogleAdsApi>
</configuration>

PHP

Learn how to get a refresh token.

Return to this page when you're done. After completing the steps, your google_ads_php.ini config file should have all you need to make test API calls, and should contain values similar to the following:

[GOOGLE_ADS]
...
developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
...
[OAUTH2]
; Required OAuth2 credentials. Uncomment and fill in the values for the
; appropriate flow based on your use case.

; For installed application flow.
clientId = "INSERT_OAUTH2_CLIENT_ID_HERE"
clientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE"
refreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE"

Python

Learn how to get a refresh token.

Return to this page when you're done. After completing the steps, your google-ads.yaml file should have all you need to make test API calls, and should contain values similar to the following:

...
developer_token: INSERT_DEVELOPER_TOKEN_HERE
client_id: INSERT_OAUTH2_CLIENT_ID_HERE
client_secret: INSERT_OAUTH2_CLIENT_SECRET_HERE
refresh_token: INSERT_OAUTH2_REFRESH_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
...

Ruby

Learn how to get a refresh token.

Return to this page when you're done. After completing the steps, your googleads_config.rb config file should have all you need to make test API calls, and should contain values similar to the following:

Google::Ads::Googleads::Config.new do |c|
  c.client_id = 'INSERT_CLIENT_ID_HERE'
  c.client_secret = 'INSERT_CLIENT_SECRET_HERE'
  c.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
  c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
end

Perl

Learn how to get a refresh token.
Return to this page when you're done. After completing the steps, your googleads.properties config file should have all you need to make test API calls, and should contain values similar to the following:
```
...
developerToken=INSERT_DEVELOPER_TOKEN_HERE
clientId=INSERT_OAUTH2_CLIENT_ID_HERE
clientSecret=INSERT_OAUTH2_CLIENT_SECRET_HERE
refreshToken=INSERT_OAUTH2_REFRESH_TOKEN_HERE
...
```

OAuth client library

First call