Magnus Erixzon > WWW-Shorten-Googl > WWW::Shorten::Googl

Download:
WWW-Shorten-Googl-1.02.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.02   Source  

NAME ^

WWW::Shorten::Googl - Perl interface to goo.gl

SYNOPSIS ^

  use WWW::Shorten::Googl;
  use WWW::Shorten 'Googl';

  $short_url = makeashorterlink($long_url);

  $long_url  = makealongerlink($short_url);

  # Note - this function is specific to the Googl shortener
  $stats = getlinkstats( $short_url );

DESCRIPTION ^

A Perl interface to the goo.gl URL shortening service. Googl simply maintains a database of long URLs, each of which has a unique identifier.

Functions ^

makeashorterlink

The function makeashorterlink will call the Googl web site passing it your long URL and will return the shorter Googl version.

If you provide your Google username and password, the link will be added to your list of shortened URLs at http://goo.gl/. See AUTHENTICATION for details.

makealongerlink

The function makealongerlink does the reverse. makealongerlink will accept as an argument either the full goo.gl URL or just the goo.gl identifier.

getlinkstats

Given a goo.gl URL, returns a hash ref with statistics about the URL.

See http://code.google.com/apis/urlshortener/v1/reference.html#resource_url for information on which data can be present in this hash ref.

AUTHENTICATION ^

If you provide your Google username and password, all shortened URLs will be available for viewing at http://goo.gl/

You provide these details by setting the environment variables GOOGLE_USERNAME and GOOGLE_PASSWORD, such as

 GOOGLE_USERNAME=your.username@gmail.com
 GOOGLE_PASSWORD=somethingVerySecret

EXPORT ^

makeashorterlink, makealongerlink

SUPPORT, LICENCE, THANKS and SUCH ^

See the main WWW::Shorten docs.

AUTHOR ^

Magnus Erixzon <magnus@erixzon.com>

SEE ALSO ^

WWW::Shorten, http://goo.gl/, http://code.google.com/apis/urlshortener/v1/reference.html#resource_url

syntax highlighting: