nicholasdejong.com

Google recently enhanced Google Alerts such that it is possible to obtain RSS feeds of canned searches.

This is enormously useful but there is no API that enables one to programaticly list, add and remove items to their set of Google Alerts. So partly because it's too cold outside to do anything and partly because this seems like useful functionality I spend a few hours today writing a PHP class that implements an API to Google Alerts.

The only required input parameters for this class are the google account username and password. Reasonable defaults are chosen for all other parameters, which can be adjusted if needed.

• username = [required] google account username
• password = [required] corrosponding google account password
• cookiefile = location of an alternate cookie file to be used. The cookie file manages and maintains the logged in session state.
• useragent = adjust the user agent presented if you feel the need.
• logtypes = an array containing the message types to be logged. Valid values are 'FATAL','ERROR','WARNING','INFO','DEBUG'.
• logterm = a bool value that determines if log messages should be sent to terminal.

Some example class instantiations:-

• $ga_api = new GoogleAlertApiClass('GOOGLE_USERNAME','GOOGLE_PASSWORD');
• $ga_api = new GoogleAlertApiClass('GOOGLE_USERNAME','GOOGLE_PASSWORD',null,null,null,FALSE);
• $ga_api = new GoogleAlertApiClass('GOOGLE_USERNAME','GOOGLE_PASSWORD',null,null,array('FATAL','ERROR','WARNING','INFO','DEBUG'),TRUE);

Functions available

• alertList() -- Can be caled once a GoogleAlertApiClass has been created. Returns an array of alert terms and their respective RSS feed URLs.
• alertAdd(string[TERM]) -- adds a new google alert. Returns 1 of sucess or 0 on failure.
• alertRemove(string[TERM]) -- removes a google alert term. Returns 1 of sucess or 0 on failure.
• alertEdit(string[OLD_TERM], string[NEW_TERM]) -- shortcut function, simply calls alertRemove and alertAdd on their respective terms. Returns 1.
• log(BOOL) -- when input is FALSE, returns an array of the last 10 enabled log type messages. When input is FALSE returns as a string.