Setup & connection

gads_get_connection_status

Where the Google Ads setup stands for this workspace: OAuth connection status (connected / error / revoked, which Google account), the authorized stored accounts with projectIds an

Where the Google Ads setup stands for this workspace: OAuth connection status (connected / error / revoked, which Google account), the authorized stored accounts with projectIds and sync freshness (readable even without OAuth), and settingsUrl — the page where a person connects or reconnects Google Ads in their browser (Google's consent screen cannot be completed by an agent). Call this first when setting up or when other tools fail with auth errors.

Type: read-only. Never changes the account.

Parameters

ParameterTypeRequiredDescription
projectIdstringNoTarget account (project id). Optional when exactly one authorized stored account exists. Use gads_list_ad_accounts or gads_get_connection_status to select among multiple accounts.

On this page