WebService::GData::Constants - constants (namespaces,format,services...) used for Google data APIs.
#don't important anything use WebService::GData::Constants; #import the namespace related constants use WebService::GData::Constants qw(:namespace); #or :format or :general or :all use WebService::GData::Base; use WebService::GData::ClientLogin; my $auth = new WebService::GData::ClientLogin(service=> BOOK_SERVICE,....); my $base = new WebService::GData::Base(); $base->query()->alt(JSON); #if not imported $base->add_namespace(WebService::GData::Constants::MEDIA_NAMESPACE); $base->add_namespace(WebService::GData::Constants::ATOM_NAMESPACE); #if imported $base->add_namespace(MEDIA_NAMESPACE); $base->add_namespace(ATOM_NAMESPACE);
This package contains some constants for Google data API available protocol formats, namespaces and general matters (version,xml header). You can import all of them by using :all or import only a subset by using :format,:namespace or :general
The general constants map the google data API version number and the xml header. You can choose to import general related constants by writing use WebService::GData::Constants qw(:general);
import with :general
The format constants map the available protocol format as of version 2 of the google data API. You can choose to import format related constants by writing use WebService::GData::Constants qw(:format);
import with :format
The namespace constants map the available namespace used as of version 2 of the google data API. You can choose to import namespace related constants by writing use WebService::GData::Constants qw(:namespace); The namespace follow the following format: xmlns:namespace_prefix="uri". In the Google Data protocol, the atom namespace is used as the default one, which means that it will be xmlns="uri". There is also an atomic version of each namespace via _PREFIX and _URI.
import with :namespace
The service constants map the available services used for the ClientLogin authentication system. Some of the service name does not map very well the API name, ie Picasa API has a service name of 'lh2'. The constants offer naming closer to the original API (PICASA_SERVICE). Not shorter but may be easier to remember. In case the service name came to change, you won't need to change it in every peace of code either. You can choose to import service related constants by writing use WebService::GData::Constants qw(:service);
import with :service
The query constants map the possible values for query parameters of version 2 of the google data API. You can choose to import query related constants by writing use WebService::GData::Constants qw(:query);
import with :query
The http status constants map the possible values for a response code from version 2 of the google data API. You can choose to import http status related constants by writing use WebService::GData::Constants qw(:http_status);
import with :http_status
The error code constants map the possible values for an error response code from version 2 of the google data API. You can choose to import error code related constants by writing use WebService::GData::Constants qw(:errors);
import with :errors
See also http://code.google.com/intl/en/apis/accounts/docs/AuthForInstalledApps.html#Errors for further informations about the errors meaning.
If you do me the favor to _use_ this module and find a bug, please email me i will try to do my best to fix it (patches welcome)!
shiriru <shirirulestheworld[arobas]gmail.com>
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install WebService::GData, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::GData
CPAN shell
perl -MCPAN -e shell install WebService::GData
For more information on module installation, please visit the detailed CPAN module installation guide.