Google::Adwords::Service - Base class for the Service modules

This documentation refers to Google::Adwords::Service version 0.16

This module is not supposed to be used directly. Use the child Service modules. See the Google::Adwords documentation for the list of available child Service modules.

These accessors/methods are available across all the child Service modules

    Creates a new Google::Adwords::*Service object

    my $service = Google::Adwords::CampaignService->new();

    NONE

    A Google::Adwords::*Service object

    Set your Google Adwords account name (your email address). This 
    value should be set before calling any other API methods

    Set your Google Adwords account password. This 
    value should be set before calling any other API methods

    Set your Google Adwords developer token. This 
    value should be set before calling any other API methods

    Set your Google Adwords application token. This 
    value should be set before calling any other API methods

    Use this if you have a MCC (My Client Center) account. Set the actual
    client email which will be used for the API calls.

    Use this if you have a MCC (My Client Center) account. Set the actual
    client customerid which will be used for the API calls.
    One of clientEmail and clientCustomerId must be set but NOT both.

    Set this to an arbitrary string that identifies the customer sending the
    request. Default value is "Google::Adwords $VERSION"

    The Adwords API version you want to use. In format 'v*'. So, to use 
    version 7 of the API, set this to a value of 'v7'. Default value is 'v9'.

    If you do $obj->use_sandbox(1), then this module will use the 
    sandbox for all API calls. 

    Set the SOAP timeout value in seconds. Default value is 35 seconds.

    Use $obj->debug(1) if you want to trace the request/response XML

    Returns version information for the Adwords API

Specifies a reference to a subroutine. The subroutine will be called whenever the service is about to create a new object. It can be used to alter the class into which new objects are blessed. Default is undef.

The subroutine is passed the default class name, and a reference to the hash of values that will be used to initialise the object. It should return the class name it wishes to use. The class name returned should be a subclass of the original class. If it returns false, the original class name will be used.

For example:

  $service->factory_class_hook( sub {
      my $class_name = shift;
      # only alter Campaign objects
      return unless $class_name eq 'Google::Adwords::Campaign';
      return "My::Adwords::WhizzoCampaign";
  } );

The following accessors are available after an API call is done. These give information about the response

Get the unique ID that identifies this request.

number of operations in the request

number of quota units the request used

elapsed time between the web service receiving the request and sending the response

* SOAP::Lite

* Class::Accessor::Chained

Rohan Almeida <rohan@almeida.in>

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.