David Torres > GOOGLE-ADWORDS-PERL-CLIENT-2.11.0 > Google::Ads::Common::AuthTokenHandler

Download:
GOOGLE-ADWORDS-PERL-CLIENT-2.11.0.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: v2.10.0   Source   Latest Release: GOOGLE-ADWORDS-PERL-CLIENT-2.16.0

NAME ^

Google::Ads::Common::AuthTokenHandler

DESCRIPTION ^

Google::Ads::Common::AuthTokenHandler implements most of the methods required to request AuthTokens using the ClientLogin protocol, see https://developers.google.com/accounts/docs/AuthForInstalledApps for more information about the protocol.

ATTRIBUTES ^

Each of these attributes can be set via the constructor as a hash. Alternatively, there is a get_ and set_ method associated with each attribute for retrieving or setting them dynamically.

email

The email of the account to authorization against.

password

The password to use for authorization.

auth_server

Endpoint of the authorization server.

auth_token

Auth token either manually set or generated.

issued_in

time in which the token was issued if it was requested by this class.

METHODS ^

initialize

Initializes the handler with properties such as the email and password to use for generating AuthTokens.

Parameters

is_auth_enabled

Returns

True, if a valid AuthToken is available or can be generated to use within API requests.

refresh_auth_token

Forces refreshing the auth token using the credentials set in the handler.

issue_new_token

Calls the authorization server to generate a new AuthToken. Sets the generated AuthToken in the auth_token property as well as the issued_in property. A captcha token and code can be passed to this method to handle captcha challenges

Parameters

Returns

Returns an error of type Google::Ads::Common::CaptchaRequiredError or Google::Ads::Common::AuthError if an error occurred while generating the token.

LICENSE AND COPYRIGHT ^

Copyright 2012 Google Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

AUTHOR ^

David Torres <david.t at google.com>

REPOSITORY INFORMATION ^

 $Rev: $
 $LastChangedBy: $
 $Id: $
syntax highlighting: