NAME
Google::Adwords - an interface which abstracts the Google Adwords SOAP API
VERSION
This documentation refers to Google::Adwords version 1.14
API VERSION
Google::Adwords currently uses version 13 (v13) 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')
->budgetAmount(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 module of the same name as the service
* CampaignService - Google::Adwords::CampaignService
* InfoService - Google::Adwords::InfoService
* AdGroupService - Google::Adwords::AdGroupService
* AccountService - Google::Adwords::AccountService
* AdService - Google::Adwords::AdService
* ReportService - Google::Adwords::ReportService
* TrafficEstimatorService - Google::Adwords::TrafficEstimatorService
* CriterionService - Google::Adwords::CriterionService
* KeywordToolService - Google::Adwords::KeywordToolService
Many services need to deal with complex data types which are available as objects
* Campaign - Google::Adwords::Campaign
* GeoTarget - Google::Adwords::GeoTarget
* CountryTargets - Google::Adwords::CountryTargets
* CityTargets - Google::Adwords::CityTargets
* MetroTargets - Google::Adwords::MetroTargets
* RegionTargets - Google::Adwords::RegionTargets
* AdSchedule - Google::Adwords::AdSchedule
* SchedulingInterval - Google::Adwords::SchedulingInterval
* BudgetOptimizerSettings - Google::Adwords::BudgetOptimizerSettings
* 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
* KeywordRequest - Google::Adwords::KeywordRequest
* KeywordEstimate - Google::Adwords::KeywordEstimate
* AdGroupRequest - Google::Adwords::AdGroupRequest
* AdGroupEstimate - Google::Adwords::AdGroupEstimate
* CampaignRequest - Google::Adwords::CampaignRequest
* CampaignEstimate - Google::Adwords::CampaignEstimate
* Business - Google::Adwords::Business
* Criterion - Google::Adwords::Criterion
* Ad - Google::Adwords::Ad
* KeywordVariation - Google::Adwords::KeywordVariation
* KeywordVariations - Google::Adwords::KeywordVariations
* SeedKeyword - Google::Adwords::SeedKeyword
* SiteKeyword - Google::Adwords::SiteKeyword
* SiteKeywordGroups - Google::Adwords::SiteKeywordGroups
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.