Stay organized with collections
Save and categorize content based on your preferences.
You need a Google API Console project for creating OAuth 2.0 credentials, and
enabling the Google Ads API for your app.
The credentials are needed for the authentication and authorization of Google Ads
users by Google servers. These credentials let you generate OAuth tokens to be
used in calls to the API.
Although you can use a single developer token for multiple projects, each
project can use only a single developer token.
Select or create a Google API Console project
Follow the instructions
to create a project. Enabling billing for your project
is optional. If you have billing enabled, select a billing account for the new
project. There is no charge for using the Google Ads API, but there is a quota on the
total number of Cloud projects.
Enable the Google Ads API in your project
To enable the Google Ads API in your project, follow these steps:
Open the API Library in the Google API Console. If prompted, select your
project or create a new one. The API Library lists all available
APIs, grouped by product family and popularity.
Use search to find the Google Ads API if it isn't visible in the list.
Select the Google Ads API, then click the Enable button.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eBefore making API calls, you must create an OAuth 2.0 client ID and client secret within a Google API Console project and note their values.\u003c/p\u003e\n"],["\u003cp\u003eYou need to configure an OAuth consent screen to define what users see regarding your project's access and data usage.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Google Ads API, you must enable it within your Google API Console project using the API Library.\u003c/p\u003e\n"],["\u003cp\u003eCreating a client ID and client secret requires selecting an application type (Desktop app or Web application) and saving the generated credentials.\u003c/p\u003e\n"]]],[],null,["# Set up a Google API Console project\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nYou need a Google API Console project for creating OAuth 2.0 credentials, and\nenabling the Google Ads API for your app.\n\nThe credentials are needed for the authentication and authorization of Google Ads\nusers by Google servers. These credentials let you generate OAuth tokens to be\nused in calls to the API.\n\nAlthough you can use a single developer token for multiple projects, each\nproject can use only a single developer token.\n\nSelect or create a Google API Console project\n---------------------------------------------\n\n| **Note:** If you already have a Google API Console project and want to use it to create credentials, you can skip to [Enable the Google Ads API in your project](#enable-api). However, you shouldn't have used this project for Google Ads API access in the past with another developer token.\n\nFollow the [instructions](/workspace/guides/create-project#project)\nto create a project. [Enabling billing for your project](/workspace/guides/create-project#billing)\nis optional. If you have billing enabled, select a billing account for the new\nproject. There is no charge for using the Google Ads API, but there is a quota on the\ntotal number of Cloud projects.\n\nEnable the Google Ads API in your project\n-----------------------------------------\n\nTo enable the Google Ads API in your project, follow these steps:\n\n1. [Open the API Library](https://console.cloud.google.com/apis/library) in the Google API Console. If prompted, select your\n project or create a new one. The API Library lists all available\n APIs, grouped by product family and popularity.\n\n2. Use search to find the Google Ads API if it isn't visible in the list.\n\n3. Select the Google Ads API, then click the **Enable** button.\n\n[Enable Google Ads API](https://console.cloud.google.com/flows/enableapi?apiid=googleads.googleapis.com)"]]
