September 1st system maintenance

We'll be performing system maintenance on the AdWords reporting infrastructure on Thurs., Sept. 1, from 12 p.m. to 6:30 p.m. (PDT). During this time, any reports pulled from the Report Service will not be up-to-date. Shortly after the system maintenance, all reports will return to normal and will include data from the maintenance period. We apologize for this inconvenience.

--Patrick Chanezon, AdWords API evangelist

August 19th system maintenance

We are performing routine AdWords system maintenance from 9pm to 11pm PDT on August 19, 2005 (Friday). While all ads will continue to run as normal, you will not be able to perform any API operations during this time. We apologize for the inconvenience.

--Patrick Chanezon, AdWords API evangelist

Changes to the AdWords keyword evaluation system live

As we explained last month, the Google AdWords keyword evaluation system will be changing to give advertisers more control over the keywords they find important. This change is now live, and you can read about the impact on API users here.

--Patrick Chanezon, AdWords API evangelist

Save bandwidth by getting your reports compressed on the wire

Want to save bandwidth downloading reports? Here's how!

rfc2616 defines a HTTP/1.1 header called Accept-Encoding. This lets HTTP clients ask for a compressed response using a header such as:

Accept-Encoding: gzip

Google servers support gzip encoding, but only for certain HTTP User-Agents. The easiest way to tell Google you really understand gzip encoding is to have the String "gzip" as part of the User-Agent, in addition to using the "Accept-Encoding: gzip" header. If you do that, reports will be transparently compressed and you'll save a lot of download time and bandwidth.

The HTTP User-Agent is different from the useragent SOAP header you use the AdWords API calls: one is used at the transport layer, the other at the application layer. We suggest that you just append the String "gzip" to the default HTTP user agent provided by your toolkit.

This is a PHP 4 sample showing how it's done (it uses libcurl):

  // open connection to the Google server via cURL
$curlConnection = curl_init();
curl_setopt($curlConnection, CURLOPT_URL, $reportURL['getReportDownloadUrlReturn']);     
curl_setopt($curlConnection, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($curlConnection, CURLOPT_ENCODING, "gzip");
curl_setopt ($curlConnection, CURLOPT_USERAGENT, curl_version() . " gzip");
// buffer for downloading report xml
ob_start();
   curl_exec($curlConnection);             
    // buffer report
    $reportXml = ob_get_contents();                       
ob_end_clean();
// end buffering
if (curl_errno($curlConnection)) {
  echo "Sorry, there was a problem while downloading your report. The cURL error message is:".curl_error($curlConnection);
  return;

(Thanks to Thomas Steiner for the sample.)

Setting HTTP headers can be done easily with any toolkits you use; keep an eye on the AdWords API Forum where other developers may post samples showing how to set these headers using other languages/libraries.

I hope this tip will help you save bandwidth when getting your API reports.

--Patrick Chanezon, AdWords API evangelist

Reminder: new quota structure in effect

As we explained a few weeks ago, the new quota structure for the AdWords API went into effect yesterday (August 1st). The Quota & Usage page gives you all the details about the new system. This change has been accompanied by a significant quota increase for most users, so fire up your favorite clients and check out what getUsageQuotaThisMonth returns. We're still working on updating the AdWords online interface, so please use the InfoService calls to retrieve quota allocation and usage information in the meantime. We'll post another note when that update is complete.

--Patrick Chanezon, AdWords API evangelist

New AdWords API features coming soon

Soon, we'll be changing the Google AdWords keyword evaluation system to help give advertisers more control over keywords they find important.

From an API perspective, there is a new minCpc field in the Keyword object that you can use to determine how much to bid in order to keep a keyword active. Keyword statuses changed a bit in the AdWords online interface, but not in the API.

In addition, with the release of the rate sheet scheduled for Aug. 1, 2005, you should have more keyword stats operations available to adjust to these keyword evaluation changes. For more information on how the new keyword evaluation system impacts the AdWords API, please visit our help page.

--Patrick Chanezon, AdWords API evangelist

New quota structure starting August 1st

Starting August 1, we’re introducing a significant change to the AdWords API quota system. The new quota structure will value operation types differently. While some operations will still consume just one quota unit, other operations will consume more - up to 1,000 quota units per operation. For example, generating a report for your whole account will now consume more quota units than downloading stats for a single keyword. As part of this overhaul, we will increase API users’ quota by 10 times. For the majority of API users, we believe this improved quota structure will result in more free API usage. Specifically, we hope this will satisfy the requests we've heard through the Developer Forum for more stats operations. For details, please see the Quota & Usage page.

-- Patrick Chanezon, Adwords API evangelist