NAME
Google::Adwords - an interface which abstracts the Google Adwords SOAP API
VERSION
This documentation refers to Google::Adwords version 0.4
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
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
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.