Class awInfoSelector

Description

Specifies the type of API usage information to be returned. API usage information returned is based on the #apiUsageType specified. All returned values are specific to the developer token being used to call

  1. InfoService.get
.

For each of the

values, other
  1. InfoSelector
fields must also be set as described below:

    1. FREE_USAGE_API_UNITS_PER_MONTH
    : Returns the number of allocated <a href="http://www.google.com/support/adwordsapi/bin/answer.py?answer=45891"> free API units</a> for this entire month. Specify only the apiUsageType parameter.
    1. TOTAL_USAGE_API_UNITS_PER_MONTH
    : Returns the total number of allocated API units for this entire month. Includes both free and paid API units. Specify only the apiUsageType parameter.
    1. OPERATION_COUNT
    : Returns the number of operations recorded over the given date range. The given dates are inclusive; to get the operation count for a single day, supply it as both the start and end date. Specify the apiUsageType and dateRange parameters.
    1. UNIT_COUNT
    : Returns the number of API units recorded.
    • Specify the apiUsageType and dateRange parameters to retrieve the units recorded over the given date range.
    • Specify the apiUsageType, serviceName, methodName and dateRange to retrieve the units recorded over the given date range for a specified method.
    1. UNIT_COUNT_FOR_CLIENTS
    : Returns the number of API units recorded for a subset of clients over the given date range. The given dates are inclusive; to get the unit count for a single day, supply it as both the start and end date. Specify the apiUsageType, dateRange and clientEmails parameters.
    1. METHOD_COST
    : Returns the cost, in API units per operation, of the given method on a specific date. Methods default to a cost of 1. Specify the apiUsageType, dateRange (start date and end date should be the same), serviceName, methodName, operator parameters.

Located in /classes/info/InfoSelector.php

awComplexObject
   |
   --awInfoSelector
Variable Summary
Variables
string $apiUsageType

The API usage type information that needs to be fetched.

<span class="constraint Required">This field is required and should not be {@code null}.</span>

  • var: awApiUsageType
long[] $clientCustomerIds

List of login customer IDs used to identify the clients to retrieve the API usage for.

If the list is null or empty, return the API usage for all clients. NOTE: Only one of clientEmails or clientCustomerIds may be specified at once.

string[] $clientEmails

List of login emails used to identify the clients to retrieve the API usage for.

If the list is null or empty, return the API usage for all clients. NOTE: Only one of clientEmails or clientCustomerIds may be specified at once.

awDateRange $dateRange

Date range to get the API usage for. The given dates are inclusive; to get the usage information for a single day, supply it as both the start and end date.

bool $includeSubAccounts

If true, include child accounts of the MCC in the search.

string $methodName

The method whose cost has been queried.

string $operator

Specifies the operator. This is applicable when the method is a "mutate" method.

  • var: awOperator
string $serviceName

The name of the service.

mixed $_checkFields = array(
'dateRange' => array(
'objName' => 'awDateRange',
'type' => 'obj'
),)
  • access: public

Redefinition of:
awComplexObject::$_checkFields

Inherited Variables

Inherited from awComplexObject

awComplexObject::$_cachedCheckFields
awComplexObject::$_row
Methods

Documentation generated on Fri, 23 Mar 2012 13:44:00 +0200 by phpDocumentor 1.4.3