Rohan Almeida > Google-Adwords-v1.14 > Google::Adwords

Download:
Google-Adwords-v1.14.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  6
Open  2
View/Report Bugs
Module Version: 1.14.0   Source  

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.

syntax highlighting: