NAME
    Email::Send::Gmail - Send Messages using Gmail

SYNOPSIS
      #!/usr/bin/perl
      use strict;
      use warnings;
      use Email::Send;
      use Email::Send::Gmail;
      use Email::Simple::Creator;

      my $email = Email::Simple->create(
          header => [
              From    => 'magic_monitoring@gmail.com',
              To      => 'acme@astray.com',
              Subject => 'Server down',
          ],
          body => 'The server is down. Start panicing.',
      );

      my $sender = Email::Send->new(
          {   mailer      => 'Gmail',
              mailer_args => [
                  username => 'magic_monitoring@gmail.com',
                  password => 'XXX',
              ]
          }
      );
      eval { $sender->send($email) };
      die "Error sending email: $@" if $@;

DESCRIPTION
    Gmail is a free Web-based email service provided by Google. This module
    is a mailer for "Email::Send" that sends a message using Gmail's
    authenticated SSL SMTP service. You must have a Gmail account and you
    should send emails 'From' that account.

    You should pass in the username and password for the Gmail account.
    Sending emails can fail for many reasons and this module croaks upon any
    errors.

  ENVELOPE GENERATION
    The envelope sender and recipients are, by default, generated by looking
    at the From, To, Cc, and Bcc headers. This behavior can be modified by
    replacing the "get_env_sender" and "get_env_recipients" methods, both of
    which receive the Email::Simple object and their only parameter, and
    return email addresses.

SEE ALSO
    Email::Send

COPYRIGHT
    Copyright (C) 2008, Leon Brocard

LICENSE
    This module is free software; you can redistribute it or modify it under
    the same terms as Perl itself.