Google::Adwords - an interface which abstracts the Google Adwords SOAP API


This documentation refers to Google::Adwords version 1.9


Google::Adwords currently uses version 11 (v11) of the Adwords API. As such, this version of Google::Adwords does not support earlier API versions. If you have a need to use earlier API versions, please use the corresponding earlier version of Google::Adwords


    use Google::Adwords::CampaignService;
    use Google::Adwords::Campaign;

    # create the service
    my $service = Google::Adwords::CampaignService->new();

    # login details

    # if you use a MCC
    # or (but not both)

    # if you want SOAP trace output

    # create a campaign object
    my $campaign = Google::Adwords::Campaign->new();

    # fill in your campaign details
    $campaign->name('my campaign #1')

    # add the campaign
    my $campaign_response = $service->addCampaign($campaign);

    # ID of new campaign
    my $campaign_id = $campaign_response->id;
    # time taken for the API call 
    my $response_time = $service->responseTime;

    # quota units consumed
    my $units_consumed = $service->units;



This collection of modules under Google::Adwords provides an easy to use object oriented interface to the Google Adwords SOAP API. You don't need to understand SOAP or web services to use this module.

Read the manual page for this module in order to see how to setup your authentication details and other options available

Each API Service belongs to a module of the same name as the service

Many services need to deal with complex data types which are available as objects


* SOAP::Lite

* Crypt::SSLeay

* Class::Accessor::Chained

* Date::Manip

* HTML::Entities


* The Yahoo::Marketing module on which this module draws heavily from

* - For the initial requirement and funding


Mailing List at


Rohan Almeida <>

Mathieu Jondet <>


Copyright (c) 2006-2008 Rohan Almeida <>. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.