Google Ads API Basic Access Application
- Application name
- Shayan Ads Manager
- Application type
- Internal Google Ads API management tool
- Applicant
- Shayan Kamali
- Applicant type
- Individual / Independent Google Ads Developer
- Access
- Single-user internal tool, not public software
- Website
- www.shayankamali.dev
Status: Shayan Ads Manager is an internal development tool built for personal, single-user operation. It is not offered as public software, is not distributed to clients, and has no public sign-up, login, or storefront.
Business Model & Google Ads API Use Case
Shayan Ads Manager is an internal, AI-assisted Google Ads API management application that I am building for my own use. It is developed using Claude Code and Python, and it connects to the Google Ads API to help me manage Google Ads accounts that I am directly authorized to manage.
- I am Shayan Kamali, an individual/self-employed Google Ads Manager and Developer.
- I am not applying on behalf of a corporation or software company.
- I manage Google Ads accounts that I am authorized to access through my Google Ads Manager account.
- I am building an internal AI-assisted Google Ads management system using Claude Code, Python, and the Google Ads API.
- Claude Code helps me build and operate Python tools that communicate with the Google Ads API.
- The tool is only for my own internal use.
- Clients and the general public cannot log in or use the software.
- The current supported campaign type is Google Search.
- API functionality includes campaign creation, campaign management, keyword planning, search-term analysis, negative keyword management, reporting, performance monitoring, and optimization.
Current Development Status
- Google Cloud project is configured.
- Google Ads API is enabled.
- OAuth 2.0 authentication has been implemented.
- OAuth credentials and refresh-token authentication have been successfully configured.
- The Google Ads Manager account is connected to an authorized production Google Ads account.
- API requests successfully reach Google Ads.
Production-account API calls currently return DEVELOPER_TOKEN_NOT_APPROVED only because Basic Access approval is pending. Google Ads API Basic Access is therefore the remaining requirement before production use.
Access & Scope
- Used exclusively by me, Shayan Kamali, for my own account management work.
- Accesses only Google Ads accounts I am authorized to manage through my Google Ads Manager Account (MCC).
- No public users, clients, or third parties interact with the tool directly.
- No public-facing login, signup, or account-creation flow exists for this tool.
- Current focus is Google Search campaigns.
Functionality
Shayan Ads Manager supports the following Google Ads management functions:
Campaign Creation
Building new Google Search campaigns with structured settings and targeting.
Campaign Management
Ongoing edits to budgets, bidding, ad groups, and campaign settings.
Keyword Planning
Researching and organizing keyword targeting for search campaigns.
Search-Term Analysis
Reviewing search query data to identify relevant and irrelevant traffic.
Negative Keyword Management
Adding and maintaining negative keyword lists to improve targeting quality.
Reporting
Pulling structured performance reports from the Google Ads API.
Performance Monitoring
Tracking campaign metrics over time to inform decisions.
Optimization
Adjusting bids, budgets, and keywords based on performance data.
Architecture
Shayan Ads Manager follows a straightforward, linear architecture:
I direct task execution through Claude Code, which is carried out by Python tools that call the Google Ads API. All API access is routed through my Google Ads Manager Account to the individual Google Ads accounts I am authorized to manage.
Why Google Ads API Access Is Required
Manually managing accounts through the Google Ads web interface does not support the programmatic, repeatable workflow this internal tool is built around. API access is required, not optional, because:
- Programmatic reporting: pulling structured performance data across campaigns on a repeatable basis is not practical through manual exports in the UI.
- Search-term analysis at scale: reviewing and filtering search-term data programmatically requires direct query access that the browser interface does not provide.
- Keyword and negative-keyword management: applying keyword and negative-keyword changes systematically across campaigns requires structured API calls rather than manual, one-by-one edits.
- Campaign operations: creating and updating campaigns, ad groups, and settings in a consistent, repeatable way requires API-driven automation rather than manual point-and-click actions.
- Automation and optimization: performance-based optimization needs to run on a schedule and respond to data automatically, which is only possible through direct, programmatic access to the Google Ads API.
Authentication & Security
- Authentication is performed using Google OAuth 2.0, and Google Ads account data is accessed only after authorization has been granted.
- API access requires a Google Ads developer token issued to my Manager Account.
- OAuth credentials and tokens are stored privately, are handled securely, and are never publicly exposed.
- No credentials, secrets, or tokens of any kind are published, embedded, or referenced on this website.
- No passwords, API keys, OAuth client secrets, refresh tokens, developer tokens, customer IDs, or private account data are displayed here or anywhere in this repository.
- Google account access can be revoked at any time through Google Account permissions.
For full details on data handling and use, see the Privacy Policy and the Terms of Service.
About the Developer
Shayan Kamali
Independent Google Ads Manager & Developer. Operator of Shayan Ads Manager.
Shayan Ads Manager is an internal development tool built solely for my own Google Ads account management. It is not offered, licensed, or distributed as public software, and it is not intended for use by any party other than myself.