Google::Adwords::CreativeService 0.6.0

Google::Adwords::CreativeService is a Perl module to interact with the Google Adwords CreativeService API calls.

SYNOPSIS

use Google::Adwords::CreativeService;
use Google::Adwords::Image;
use Google::Adwords::Creative;

use File::Slurp;

# create the CreativeService object
my $creative_service = Google::Adwords::CreativeService->new();

# need to login to the Adwords service
$creative_service->email($email_address)
->password($password)
->developerToken($developer_token)
->applicationToken($app_token);

# if you have a MCC
$creative_service->clientEmail($client_email);

my $adgroupid = 123456789;

# get all the creatives for an adgroup
my @getallcreatives = $creative_service->getAllCreatives($adgroupid);
for ( @getallcreatives ) {
print "Creative name : " . $_->name . " , Id : " . $_->id . "n";
}

# get a specific creative from an AdGroup
my $creativeid = 987654321;

my $getcreative = $creative_service->getCreative($adgroupid, $creativeid);
print "Get creative: " . $getcreative->name . ", Id : " . $getcreative->id . "n";

# activate a creative
my $ret = $creative_service->activateCreative($adgroupid, $creativeid);

# activate a list of creative
my @activate_list = (
{
adGroupId => 1234,
creativeId => 12,
},
{
adGroupId => 5789,
creativeId => 209,
},
);
my $ret = $creative_service->activateCreativeList(@activate_list);

# delete a creative
my $ret = $creative_service->deleteCreative($adgroupid, $creativeid);

# add a creative
my $creative_text = Google::Adwords::Creative->new
->adGroupId($adgroupid)
->destinationUrl(http://www.example.com)
->displayUrl(http://www.example.com)
->headline(API : creative)
->description1(desc1 added via API)
->description2(desc2 added via API);

my $addcreative = $creative_service->addCreative($creative_text);
print "Added Creative ID: " . $addcreative->id . "n";

# add a image creative
my $data_blurb = read_file(image.gif);

my $image = Google::Adwords::Image->new
->name(Image #1)
->data($data_blurb)
->type(image);

my $creative_image = Google::Adwords::Creative->new
->adGroupId($adgroupid)
->destinationUrl(http://www.example.com)
->displayUrl(http://www.example.com)
->image( $image );

my $addcreative = $creative_service->addCreative($creative_image);
print "Added Creative ID: " . $addcreative->id . "n";
print "Image Height: " . $addcreative->image->height . "n";

This module provides an interface to the Google Adwords CreativeService API calls. Please read Google::Adwords::Creative on how to setup and receive information about your creatives.