使用googleapi-client-java操作gtasks（一）
Google Tasks的API终于开放了，可以方便的保存树状工作任务，对照文档和例子摸索了一遍，将一些关键点给大家分享一下。
如果对于googleapi-client-java库没什么了解，可以参考我前面的一篇文章：
http://mypyg.iteye.com/admin/blogs/816237
当然这个库自从那个时候后又更新了很多，好用多了。
下载库：
http://code.google.com/p/google-api-java-client/wiki/APIs
这里面的包每个都包含了google api client，并且根据服务的不同，进行了各自的扩展，我们这儿选择Tasks的API，下载库，另外还有文档，还有个更有意思的：https://code.google.com/apis/explorer/#_s=tasks&_v=v1,API浏览页面，可以直接输入法参数然后与服务器通信很直观的看到与服务器交换的数据内容，因为要访问个人数据，使用explorer时注意右上角 Switch to Private Access，切换到授权模式。
阅读示例代码http://code.google.com/p/google-api-java-client/source/browse/taskqueue-json-oauth-sample?repo=samples
打开eclipse，首选创建一个空project，将刚才下载的zip包导入此项目，以方便其他项目引用其中的jar包。
然后创建一个新项目，设置build path，要手工加上以下几个包的依赖：
google-api-client-1.7.0
google-api-client-android2-1.7.0
google-api-tasks-v1-rev2-java-1.4.0
google-http-client-1.7.0
google-http-client-android2-1.7.0
google-oauth-client
guava-11.0.1
jackson-coer-asl
如果不加的话，最终生成apk包时不会包含，会导致运行时出现类找不到的情况。
其中android2的两个包时针对android sdk 2以上平台的，都是在相应的通用包上作了一点扩展，但是并没有包含通用包，所以对应的通用包也要加入build path。如果sdk是3的，那么就替换成android3的包。
使用google服务的流程：
1.使用用户名、密码获取授权Token（令牌，没有的话google不让访问数据，使用用户名和密码从google服务器获得）。
2.使用授权字符串以及其他的参数发送http请求。
3.解析响应，并处理结果。
在Android平台上获取授权可以通过AccountManager服务来实现，只要有绑定的Gmail账户，就无须再次输入密码。发送请求以及解析响应则通过googleapi-client-java库中封装的函数来实现了。
下面就结合实际的代码做下说明：
基础类：
com.google.api.services.tasks.v1.Tasks.Tasks：Tasks服务的封装类。
构造函数：
Tasks(HttpTransport transport, HttpRequestInitializer requestInitializer, JsonFactory jsonFactory)
/** *保存Token的类，实现了接口HttpRequestInitializer，会在HTTP请求头中增加一行 *Authorization: Oath {你得到的token} **/private GoogleAccessProtectedResource mAccessProtectedResource = new GoogleAccessProtectedResource(null);//通过Http协议传输数据的类private final HttpTransport mTransport = AndroidHttp.newCompatibleTransport();//Google Tasks服务对象private Tasks mService = new Tasks(mTransport, mAccessProtectedResource, new JacksonFactory());//账户管理对象private GoogleAccountManager mAccountManager = new GoogleAccountManager(this);//token类型：tasks的约定即为此字符串。不要漏了前面的oauth2:否则一直提示密码错误//或者使用tasks的auth token类型别名"Manage your tasks"。参见:http://code.google.com/apis/tasks/oauth-android-auth-token-type-aliases.html//这样用户看到的就不是一个url，而是一个可以理解的字符串。//所有的别名列表网上找不到了，好多人在问private static final String AUTH_TOKEN_TYPE = "oauth2:https://www.googleapis.com/auth/tasks";//获取TokenmAccountManager.manager.getAuthToken(account, AUTH_TOKEN_TYPE, true, new AccountManagerCallback<Bundle>() {@Overridepublic void run(AccountManagerFuture<Bundle> future) {try {Bundle bundle = future.getResult();if(bundle.containsKey(AccountManager.KEY_INTENT)) {Intent intent = bundle.getParcelable(AccountManager.KEY_INTENT);intent.setFlags(intent.getFlags() & ~Intent.FLAG_ACTIVITY_NEW_TASK); //弹出窗口用户选择是否允许访问Google Tasks数据startActivityForResult(intent, REQUEST_AUTHENTICATE);}else if(bundle.containsKey(AccountManager.KEY_AUTHTOKEN)) { //得到授权字符串并保存mAccessProtectedResource.setAccessToken(bundle.getString(AccountManager.KEY_AUTHTOKEN)); //从服务器获取数据onAuthToken();}}catch(Exception e) {handleException(e);}}}, null);private void onAuthToken() { List<String> tasks = new ArrayList<String>(); try { /*向服务器发送请求，并解析成列表。 在这个过程中实际上向服务器发送了： GET https://www.googleapis.com/tasks/v1/users/@me/lists Authorization: OAuth {Token xxx x xx x x x} X-JavaScript-User-Agent: Google APIs Explorer google-api-gwt-client/0.1-alpha 服务器回应了： 200 OK 以及一个包含有所有列表的Json对象。 */List<TaskList> lists = mService.tasklists.list().execute().items;for(TaskList tl : lists) {tasks.add(tl.title);}setListAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, tasks));} catch (IOException e) {handleException(e);} }mService.accessKey = 你的API_KEY;