使用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)

参数transport:通过http交互数据的封装类。
参数requestInitializer：对http request进行初始化的对象
参数jsonFactory：解析、构造json数据的对象
代码片段(代码具体位置参见附件，文章的代码只是为了方便讲解，位置都是乱的)：
1.基本对象

/**
 *保存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);

2.获得Token并保存

//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";
//获取Token
mAccountManager.manager.getAuthToken(account, AUTH_TOKEN_TYPE, true, new AccountManagerCallback<Bundle>() {
			@Override
			public 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);

3.从服务器获取数据：

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);
			}
    }

4.关于API KEY:
如果直接使用Google的例子编译后运行，会发现服务器回应400 Bad request，跟踪发现是因为API KEY没有设置的原因(访问Google Calendar就没这个限制)，Google为了防止资源被滥用，通过API KEY来限制Ap，比如Gtasks就限制每个API KEY每天只能访问5000次（一个请求就是1次），而且API KEY是跟着Ap走的，比如一个Ap有5000个人安装了，那么平均每个人每天只能访问1次Google Tasks服务了，即使这5000个人有5000个Google账户也是被这么限制。那么如何不受此限制呢？
我想的方法之一是Ap启动时，要求用户输入自己的API KEY，那么这样所有的用户就互不干扰了，各自都有5000次的可用次数了。
API Key的获得：
直接访问网址： https://code.google.com/apis/console#access
如果从来没有来过此网址，那么第一页会让你create project，点击后进入下一个页面，选择Services，把Tasks API的开关选择为ON，再选择API Access，在Simple API Access的框内就可以看到API KEY了，复制了即可。
API KEY在代码中的设置：

mService.accessKey = 你的API_KEY;