OAuth Service Account Flow

Warning: Starting March 31, 2024, the Google Ads API client library for PHP will no longer support PHP versions below 8.1. To ensure seamless operation, we strongly recommend upgrading your PHP version before this date.

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

Create OAuth2 credentials

Note: This flow requires a Google Workspace domain and the service account that you created needs to be granted domain wide delegation access by a super administrator for the domain.

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

Set up client library with JSON file

Configure the following keys in your google_ads_php.ini. See the configuration guide for additional details.

; For service account flow.
jsonKeyFilePath = "path/to/your/oauth2/key/file.json"
scopes = "https://www.googleapis.com/auth/adwords"
impersonatedEmail = "[e-mail]"