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


This documentation refers to Google::Adwords version 0.5


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

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

    # login details

    # if you use a MCC

    # 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.

* Base Service Class - Google::Adwords::Service

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 particular module.

* CampaignService - Google::Adwords::CampaignService

* InfoService - Google::Adwords::InfoService

* AdGroupService - Google::Adwords::AdGroupService

* AccountService - Google::Adwords::AccountService

* CreativeService - Google::Adwords::CreativeService

* ReportService - Google::Adwords::ReportService

Some services like the CampaignService need to deal with complex data types which are available as objects.

* Campaign - Google::Adwords::Campaign

* StatsRecord - Google::Adwords::StatsRecord

* AdGroup - Google::Adwords::AdGroup

* ClientUsageRecord - Google::Adwords::ClientUsageRecord

* AccountInfo - Google::Adwords::AccountInfo

* EmailPromotionsPreferences - Google::Adwords::EmailPromotionsPreferences

* Address - Google::Adwords::Address

* CoverageType - Google::Adwords::CoverageType

* CreditCard - Google::Adwords::CreditCard

* Creative - Google::Adwords::Creative

* Image - Google::Adwords::Image

* ReportJob - Google::Adwords::ReportJob

Please read the documentation for the above modules.


* SOAP::Lite


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

* - For the initial requirement and funding


Rohan Almeida <>

Mathieu Jondet <>


Copyright (c) 2006 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.