This project hosts the Python client library for the Google Ads API.
- Distributed via PyPI.
- Easy management of credentials.
- Easy creation of Google Ads API service clients.
- Python 2.7.13+ / 3.5.3+
- pip
This library is distributed via PyPI. If you have not already done so, install pip, the following command to install this client library:
pip install google-ads
To authenticate your API calls, you must specify your client ID, client secret, refresh token, developer token, and, if you are authenticating with a manager account, a login customer id. If you have not yet created a client ID, see the Authorization guide and the authentication samples to get started. Likewise, see Obtain your developer token if you do not yet have one.
When initializing a GoogleAdsClient instance via the load_from_storage class method, the default behavior is to load a configuration file named google-ads.yaml located in your home directory. Included in this repository is a template you can use.
You can run the following to retrieve a GoogleAdsClient instance using a configuration file named google-ads.yaml stored in your home directory:
client = google.ads.google_ads.client.GoogleAdsClient.load_from_storage()
You can use a GoogleAdsClient instance to retrieve any type or service used by the API. To retrieve a type such as a CampaignOperation, provide its name to the get_type method:
campaign_operation = client.get_type('CampaignOperation')
Likewise, you can provide the name of a service to get_service in order to retrieve the corresponding service client instance:
google_ads_service = client.get_service('GoogleAdsService')