NAME

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

VERSION

This documentation refers to Google::Adwords version 0.5

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

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

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

DEPENDENCIES

* SOAP::Lite

THANKS

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

* betonmarkets.com - For the initial requirement and funding

AUTHORS

Rohan Almeida <rohan@almeida.in>

Mathieu Jondet <mathieu@eulerian.com>

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

cpanm Google::Adwords

perl -MCPAN -e shell
install Google::Adwords