The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

VERSION

This documentation refers to Google::Adwords version 1.9.1

API VERSION

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

SYNOPSIS

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

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

    # login details
    $service->email('email@domain.com')
            ->password('password')
            ->developerToken($developer_token)
            ->applicationToken($app_token);

    # if you use a MCC
    #$service->clientEmail('clientemail@domain.com');
    # or (but not both)
    #$service->clientCustomerId('xxx-xxx-xxxx');

    # if you want SOAP trace output
    #$service->debug(1);

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

    # fill in your campaign details
    $campaign->name('my campaign #1')
             ->dailyBudget(100000)
             ->status('Paused');

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

  

DESCRIPTION

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

DEPENDENCIES

* SOAP::Lite

* Crypt::SSLeay

* Class::Accessor::Chained

* Date::Manip

* HTML::Entities

THANKS

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

* betonmarkets.com - For the initial requirement and funding

SEE ALSO

Mailing List at https://lists.sourceforge.net/lists/listinfo/google-adwords-perl

AUTHORS

Rohan Almeida <rohan@almeida.in>

Mathieu Jondet <mathieu@eulerian.com>

LICENSE AND COPYRIGHT

Copyright (c) 2006-2008 Rohan Almeida <rohan@almeida.in>. 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.