网页读取并嵌入Google Docs文档及表格(PHP)

什么是 Google 数据 API?
Google 数据 API 提供用于在网络上读写数据的简单标准协议。 这些 API 可以使用基于 XML 的两种标准联合格式:Atom 或 RSS。它们还具有一个供稿发布系统,其中包括 Atom 发布协议和用于处理查询的一些扩展功能(使用 Atom 的标准扩展模型)。 许多 Google 服务都支持 Google 数据 API 协议。以下数据 API 可以使您的客户端应用程序与 Google 服务进行互动:
- Google 企业应用套件 API
- Google Base 数据 API
- Blogger 数据 API
- Google 图书搜索数据 API
- Google 日历数据 API
- Google Code 搜索数据 API
- Google Contacts 数据 API
- Google 财经文件夹数据 API
- Google Health 数据 API
- Google 记事本数据 API
- Google 电子表格数据 API
- Picasa 网络相册数据 API
- Google 在线文档列表数据 API
- 网站管理员工具数据 API
- YouTube 数据 API
动机
这几天我在做自己的一个网站制作及托管服务的网站,牵涉到一些客户信息的管理什么的,最好是能做成OA之类的形式,就像Google Docs里的SpreadSheet一样,在线编辑,在线显示。不过我实在没时间去自己做这种东西,于是我在想是不是能直接通过API把Google Docs里的SpreadSheet直接嵌入我自己写的网页里去。不见得需要编辑功能,估计Google也不会提供,不然Google Docs不就变成带有后门的网站留言文本编辑器了么...(所谓带有后门,是指与一般留言文本编辑器不同,不是把数据存储在本地网站,而是存储在另一个服务器,在这里就是Google Docs服务器上)

站在巨人的肩上,感谢Lim Jiunn Haur写的WordPress插件Inline Google Docs早就提供了这个功能,我把这个插件拆开,去掉多余的,为我所用了。

使用方法
用法很简单,后面的相关下载中提供了一个RAR包,当中包含两个文件夹,styles里包含了一个CSS,用于修饰SpreadSheet表格显示的效果,这里的风格基本上是白灰风格,如上图所示。鉴于保密需求我做了模糊处理,反正就那么个意思。你需要在你的网站中加入这个CSS或者将这个集成到你的CSS中,或者干脆不要,自己写。 includes文件夹是库,其中Zend是Google Data API库,由Google发布。gdocs是本文所述的库。加载Google Data API库的代码在gdocs下gdocs.php中,你可能需要做一点路径修改之类。至少在你的全局include库的地方加入Zend的位置,并include gdocs.php这个文件。
/* Add Zend library to path */ $path = dirname (FILE) . "/includes"; set_include_path (get_include_path () . PATH_SEPARATOR . $path);
另有一个全局配置文件config.php,我并没有给出,你自己要补上。示例如下:
/* Site Configuration */ define('SITE_URL', 'http://www.yourdomain.com/');
/* Google Docs Settings */ define('GOOGLE_DOMAIN', 'yourdomain.com'); define('GOOGLE_USERNAME', '[email protected]'); define('GOOGLE_PASSWORD', 'YourGooglePassword'); define('PROXY_HOST', ''); define('PROXY_PORT', ''); define('PROXY_USERNAME', ''); define('PROXY_PASSWORD', '');
调用显示Google Docs中包含的文档时,PHP代码如下:
gdocs_list();
具体的显示风格请自行修改includes的gdocs下,gdisplay.php文件。
调用显示某一个具体的SpreadSheet的时候,$atts['type']置'spreadsheet',st_id为SpreadSheet的ID,例如'pNrLCrMF9srEYeIRCLO5kEF',wt_id为工作表ID,例如'od6',PHP代码如下:
$atts['type'] = $_GET['type']; $atts['st_id'] = $_GET['st_id']; $atts['wt_id'] = $_GET['wt_id']; $atts['style'] = 'googledocs'; $atts['headings'] = NULL;
gdocs_display($atts);
注意事项
- 按照原作者Lim Jiunn Haur代码中的声明,本作品源代码依旧遵循GNU Public License。
- 修改之后的代码示例只包含了必要的我能用到的功能,就是对Google Docs中Document和SpreadSheet的列表,以及SpreadSheet的显示功能,其他功能并未写出实例,但是包含的Google Data API是完整的,应该可以写出进一步功能的代码,这里留给读者去自行研究吧。