/ 
WebService-GData-0.0102
River stage zero No dependents
/ WebService::GData::Constants

NAME

WebService::GData::Constants - constants (namespaces,format,services...) used for Google data APIs v2.

VERSION

0.01

SYNOPSIS

    #don't important anything
	use WebService::GData::Constants; 

	#import the namespace related constants
	use WebService::GData::Constants qw(:namespace :service :format); #or :format or :general or :all

	use WebService::GData::Base;
	use WebService::GData::ClientLogin;

	
	my $auth = new WebService::GData::ClientLogin(service=> BOOK_SERVICE,....);

    #create an object that only has read access
   	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);

DESCRIPTION

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,:general

GENERAL CONSTANTS

The general consants map the google data API version number and the xml header.

You can choose to import format related constants by writing use WebService::GData::Constants qw(:general);

GDATA_MINIMUM_VERSION

XML_HEADER

import with :general

FORMAT CONSTANTS

The format consants 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);

JSON

JSONC

RSS

ATOM

import with :format

NAMESPACE CONSTANTS

The namespace consants 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_name="uri"

ATOM_NAMESPACE

OPENSEARCH_NAMESPACE

GDATA_NAMESPACE

GEORSS_NAMESPACE

GML_NAMESPACE

MEDIA_NAMESPACE

APP_NAMESPACE

import with:namespace

SERVICE CONSTANTS

The service consants 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);

ANALYTICS_SERVICE =head2 APPS_SERVICE =head2 BASE_SERVICE =head2 SITES_SERVICE =head2 BLOGGER_SERVICE =head2 BOOK_SERVICE =head2 CALENDAR_SERVICE =head2 CODE_SERVICE =head2 CONTACTS_SERVICE =head2 DOCUMENTS_SERVICE =head2 FINANCE_SERVICE =head2 GMAIL_SERVICE =head2 HEALTH_SERVICE =head2 HEALTH_SB_SERVICE =head2 MAPS_SERVICE =head2 PICASA_SERVICE =head2 SIDEWIKI_SERVICE =head2 SPREADSHEETS_SERVICE =head2 WEBMASTER_SERVICE =head2 YOUTUBE_SERVICE

CONFIGURATION AND ENVIRONMENT

none

DEPENDENCIES

none

INCOMPATIBILITIES

none

BUGS AND LIMITATIONS

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)!

AUTHOR

shiriru <shiriru0111[arobas]hotmail.com>

LICENSE AND COPYRIGHT

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.