'description' => 'Access Gmail mailboxes including sending user email.', 'version' => 'v1' 'rootUrl' => 'https://www.googleapis.com/', 'servicePath' => '/gmail/v1/users/', { 'id' => 'gmail:v1', 'title' => 'Gmail API', 'description' => 'Access Gmail mailboxes including sending user email.', 'icons' => { 'x16' => 'https://www.google.com/images/icons/product/googlemail-16.png', 'x32' => 'https://www.google.com/images/icons/product/googlemail-32.png' }, 'name' => 'gmail', 'preferred' => true, 'discoveryRestUrl' => 'https://www.googleapis.com/discovery/v1/apis/gmail/v1/rest', 'version' => 'v1', 'documentationLink' => 'https://developers.google.com/gmail/api/', 'kind' => 'discovery#directoryItem', 'discoveryLink' => './apis/gmail/v1/rest' }, ## SEE ALSO - https://github.com/APIs-guru/openapi-directory/blob/master/APIs/googleapis.com/gmail/v1/swagger.yaml

GOALS

  - show summary details pulled from discovery docs 
  - show all methods in HTML table with description including code snippets for worked examples
  - describe helper functions the simplify data handling
  - inform improvements to core Modules ( param parsing / validation / feature evolution etc )
  - idenitfy opportunities for use in full working applications 

LIST

 SCOPES TO access messages->list->
        'https://mail.google.com/',
        'https://www.googleapis.com/auth/gmail.metadata',
        'https://www.googleapis.com/auth/gmail.modify',
        'https://www.googleapis.com/auth/gmail.readonly'

 

GET {userId}/messages/{id}

  {
      format => [ ... 'full', ],

  }
        'https://mail.google.com/',
        'https://www.googleapis.com/auth/gmail.metadata',
        'https://www.googleapis.com/auth/gmail.modify',
        'https://www.googleapis.com/auth/gmail.readonly'

send

    'httpMethod' => 'POST'
    path' => '{userId}/messages/send',
    'mediaUpload' => { accept =>'message/rfc822', maxSize => 35MB, protocols=> {simple=> resumable => }

        'https://mail.google.com/',
        'https://www.googleapis.com/auth/gmail.compose',
        'https://www.googleapis.com/auth/gmail.modify',
        'https://www.googleapis.com/auth/gmail.send'

review_emails_from_last_month_using_agent( $gapi )

A simple email send example. Creates an encoded RFC

TODO: * handle pagination where results list exceeds single query response maximimum - indicated by tokens in reponse

REFERENCES: construct 'q' query filters as per https://support.google.com/mail/answer/7190?hl=en

get_email_content_from_id_using_agent( $id, $gapi )

Get a single email and extract content

TODO: extract the attachments

send_email_to_self_using_client( $gapi )

A simple email send example. Creates an encoded RFC

TODO: * refactor to use email address from config file

NAME

gmail_example.pl - gmail service examples

VERSION

version 0.04

SYNOPSIS

    gmail_example.pl [gapi.json] 

Assumptions

* scope within gapi.json authorises read access to Gmail APIs

AUTHOR

Peter Scott <peter@pscott.com.au>

COPYRIGHT AND LICENSE

This software is copyright (c) 2018 by Peter Scott.

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

cpanm WebService::GoogleAPI::Client

perl -MCPAN -e shell
install WebService::GoogleAPI::Client