OAuth Service Account Flow

This guide will walk you through how to setup OAuth2 for API access using your own credentials using server-to-server flow. These steps only need to be done once, unless you revoke or delete your OAuth2 credentials.

Step 1 - Creating OAuth2 Credentials

Generate a service (delegate) account ID and a *.JSON file by following the linked instructions, then come back to this page.

Step 2 - Adding Private Key JSON and Delegate Account to Configuration

  1. Set the private key JSON file path and delegate account ID in your configuration. If you're using a google-ads.yaml file, YAML string or dict add the following:

    path_to_private_key_file: INSERT_PRIVATE_KEY_FILE_PATH
    delegated_account: INSERT_DELEGATE_ACCOUNT
    

    If you're using environment variables add the following to your bash configuration or environment:

    export GOOGLE_ADS_PATH_TO_PRIVATE_KEY_FILE=INSERT_PRIVATE_KEY_FILE_PATH
    export GOOGLE_ADS_DELEGATE_ACCOUNT=INSERT_DELEGATE_ACCOUNT_ID