The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Google::Ads::Common::OAuth2ServiceAccountsHandler

DESCRIPTION

A generic abstract implementation of Google::Ads::Common::OAuth2BaseHandler that supports OAuth2 for Service Accounts semantics.

It is meant to be specialized and its _scope method be properly implemented.

ATTRIBUTES

Each of these attributes can be set via Google::Ads::Common::OAuth2ServiceAccountsHandler->new().

Alternatively, there is a get_ and set_ method associated with each attribute for retrieving or setting them dynamically.

api_client

A reference to the API client used to send requests.

client_id

OAuth2 client id obtained from the Google APIs Console.

email_address

Service account email address as found in the Google API Console.

delegated_email_address

Delegated email address of the accounts that has access to the API.

pem_file

Private key PEM file path. Keep in mind that the Google API Console generates files in PKCS12 format and it should be converted to PEM format with no password for this module to function.

access_token

Stores an OAuth2 access token after the authorization flow is followed or for you to manually set it in case you had it previously stored. If this is manually set this handler will verify its validity before preparing a request.

METHODS

initialize

Initializes the handler with properties such as the client_id and client_secret to use for generating authorization requests.

Parameters

  • A required api_client with a reference to the API client object handling the requests against the API.

  • A hash reference with the following keys: { # Refer to the documentation of the client_id property. oAuth2ClientId => "client-id", # Refer to the documentation of the email_address property. oAuth2ServiceAccountEmailAddress => "email-address", # Refer to the documentation of the delegated_email_address property. oAuth2ServiceAccountDelegateEmailAddress => "delegated-email-address", # Refer to the documentation of the pem_file property. oAuth2ServiceAccountPEMFile => "pem-file-path", # Refer to the documentation of the access_token property. oAuth2AccessToken => "access-token", }

is_auth_enabled

Refer to Google::Ads::Common::AuthHandlerInterface documentation of this method.

prepare_request

Refer to Google::Ads::Common::AuthHandlerInterface documentation of this method.

LICENSE AND COPYRIGHT

Copyright 2013 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: $

1 POD Error

The following errors were encountered while parsing the POD:

Around line 227:

You forgot a '=back' before '=head2'