Google Ads APIs Client Library for PHP (AdWords and DFP)
This project hosts the PHP client library for the various SOAP-based Ads APIs (AdWords and DFP) at Google.
Welcome to the new ads API PHP client library!
The ads API PHP client library has been rewritten. If you're new to this library, read on! If you're already using our library, you may want to take a look at our Upgrading guide first.
Install the latest version using Composer.
$ php composer.phar require googleads/googleads-php-lib
Copy the sample
adsapi_php.inifor your product to your home directory and fill out the required properties.
Setup your OAuth2 credentials.
The AdWords and DoubleClick for Publishers APIs use OAuth2 as the authentication mechanism. Follow the appropriate guide below based on your use case.
If you're accessing an API using your own credentials...
If you're accessing an API on behalf of clients...
The best way to learn how to use this library is to review the examples for your product.
All our examples are meant to be run via the command line and not as a webpage.
If you're using 32-bit PHP, you may need to change
intval()of any examples to
floatval()when running them. This is because some IDs would be larger than 32-bit
PHP_INT_MAX. In that case,
intval()would return incorrect values.
The following snippet of code from the BasicOperations/GetCampaigns.php example for AdWords gives you an idea of how to use this library. The usage pattern is similar for DFP.
use Google\AdsApi\AdWords\AdWordsServices; use Google\AdsApi\AdWords\AdWordsSessionBuilder; use Google\AdsApi\AdWords\v201609\cm\CampaignService; use Google\AdsApi\AdWords\v201609\cm\OrderBy; use Google\AdsApi\AdWords\v201609\cm\Paging; use Google\AdsApi\AdWords\v201609\cm\Selector; use Google\AdsApi\Common\OAuth2TokenBuilder; $oAuth2Credential = (new OAuth2TokenBuilder()) ->fromFile() ->build(); $session = (new AdWordsSessionBuilder()) ->fromFile() ->withOAuth2Credential($oAuth2Credential) ->build(); $adWordsServices = new AdWordsServices(); $campaignService = $adWordsServices->get($session, CampaignService::class); // Create selector. $selector = new Selector(); $selector->setFields(array('Id', 'Name')); $selector->setOrdering(array(new OrderBy('Name', 'ASCENDING'))); // Create paging controls. $selector->setPaging(new Paging(0, 100)); // Make the get request. $page = $campaignService->get($selector); // Do something with the $page.
fromFile() method looks for an
adsapi_php.ini file in your
home directory by default. If you want to store this file in another directory,
pass the path of the file as an argument. For example:
It is highly recommended that you use an
adsapi_php.ini file. However, if you
don't want to or can't use it, you can also use the OAuth2 token and ads session
builders to set the same information. See the builders for details:
Note that some WSDL object types have names that are reserved PHP keywords and need to be augmented when used as PHP class names. The following is a list of these occurences.
Some WSDL enum values have names that are reserved PHP keywords and need to be
modified when used as PHP constant names. For examples,
This library conforms to PSR-3 for logging and provides the following loggers:
- SOAP logger
- Report downloader logger
- Batch jobs utility logger
- SOAP logger
- Report downloader logger
In general, each logger logs a summary and debug message for events (e.g., a SOAP API call). The level at which messages are logged depends on whether the event succeeded.
|Log message \ Event status||Success||Failure|
|Debug message (e.g., SOAP payload)||DEBUG||NOTICE|
You may configure some options for these default loggers in the
[LOGGING] ; Optional logging settings. soapLogFilePath = "path/to/your/soap.log" soapLogLevel = "NOTICE"
If you need to further customize logging, you may specify your own logger entirely by providing a logger that implements LoggerInterface in either the AdWords or DFP session builders:
$session = (new AdWordsSessionBuilder()) ... ->withSoapLogger(new MyCustomSoapLogger()) ->withReportDownloaderLogger(new MyCustomReportDownloaderLogger()) ->build();
$options = [ 'stream_context' => [ 'http' => ['timeout' => 120] ] ]; $requestOptionsFactory = new RequestOptionsFactory($session, $options); $reportDownloader = new ReportDownloader($session, $requestOptionsFactory);
PHPDoc is not yet available for the new ads API PHP library. Please follow the PHPDoc issue for updates.
General AdWords and DFP API documentation can be found on our Google Developers site.
For client library specific bug reports, feature requests, and patches, please create an issue on the issue tracker.
For general AdWords and DFP API questions, bug reports, or feature requests, please post to our API forums:
For general ads API and client library updates and news, please follow or join our:
- Google+ Ads Developers page
- Google Ads Developers blog
- AdWords API Announcements mailing list
- DFP API Sunset Announcements mailing list
API deprecation schedules can be found at: