NAME

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

VERSION

This documentation refers to Google::Adwords version 1.2.3

API VERSION

Google::Adwords currently uses version 8 (v8) of the Adwords API which is the default. You can also opt to use version 7 if you wish. Just set the api_version() in your *Service objects to 'v7'.

    # use v7 of the Adwords API
    $campaign_service->api_version('v7');

 

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');

    # To use an earlier version of the Adwords API
    #$service->api_version('v7');

    # 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

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