blanchardjeremy / google-groups-php-api

Provides access to Google Groups using a faux-API (emulating a browser to take actions as if it were a user).
http://activismlabs.org
35 stars 9 forks source link

Introduction

This library gives programatic access to Google Groups from PHP. It does so by emulating a user's interaction with a browser (AKA "a bot" or "screen scraping"). I can be thought of as a faux-API.

If you would like to encourage Google to create a real API, post in this thread (or "star it"): Groups API.

This library requires that you specify the username and password for a Google Account with manager/admin access to each group that you want to manipulate.

NOTE: This library comes with no gaurentee of service. If Google changes the format of pages or any form submission process, this library may cease to function.

Features

Current features include:

TODO

API functions to add:

Other TODO items:

Examples

View examples of this script in the exmaples directory.

Notes: You must edit the example file to include your username/password and other settings.

Bugs and Feature Requests

Please submit bug reports and feature requests at the Google Groups PHP API GitHub project page.

Testing

A test library with moderate test coverage comes with this library. They are available in the tests directory.

To run the tests, edit the tests/test_config.php file to contain a username/password to use for testing. Then visit the tests/autorun_tests.php from your browser to execute the entire test suite.

Legal

To my best (non-expert) reading of the Google Groups Terms of Service, I think that is permissible to use this API. That said, using the library to force-add users to a group for the purposes of SPAM could result in the API being removed.

License

This code is available under GPL v2.

Development

Development details are available at Google Groups PHP API GitHub project page.

This library may not see a stable release for some months. Currently, development is being done as a proof-of-concept. Use at your own risk.

Written by Jeremy Blanchard from Activism Labs.