Google Bookmark API（Google书签接口）

最新推荐文章于 2024-08-08 07:34:39 发布

zidangtou515

最新推荐文章于 2024-08-08 07:34:39 发布

阅读量845

点赞数

分类专栏： Android 文章标签： Google Android 编程 Gmail XML

Android 专栏收录该内容

17 篇文章 0 订阅

订阅专栏

最近做了google书签同步的模块，发现google并没有公开bookmark相关的api接口，在网上也找了些资料，通过自己抓包分析，测试，总结下使用bookmark接口的心得，我是在android下测试的，应该不存在编程语言的问题。

1.登录google账户（POST）

由于google bookmark没有公布api，测试google各种认证方式并通过抓包分析，发现想要获得bookmark服务，在请求时必须传递已登录后的Cookie信息。

请求：https://www.google.com/accounts/ServiceLoginAuth

头信息：Cookie="GALX=任意字符串" (此头信息必须有，其他头信息可根据需求添加，否则无法获取到Cookie,任意字符串也很重要，请求参数和此处应一致)

参数：GALX="字符串" （头信息中定义的GALX字符串，必须一致）

Email="用户名"

Passwd="密码"

Java代码可以用DefaultHttpClient方式测试，该类提供了获取和设置Cookie方法，通过验证Cookie中是否有SID，即可验证是否正确登录获得了Cookie。

/**
	 * 登录google账户
	 */
	private boolean googleLogin() {
		HttpPost post = new HttpPost("https://www.google.com/accounts/ServiceLoginAuth");

		post.addHeader("Cookie", "GALX=zidangtou");

		List<NameValuePair> nvps = new ArrayList<NameValuePair>();
		nvps.add(new BasicNameValuePair("GALX", "zidangtou"));
		nvps.add(new BasicNameValuePair("Email", "******@gmail.com"));
		nvps.add(new BasicNameValuePair("Passwd", "*****"));

		try {
			post.setEntity(new UrlEncodedFormEntity(nvps));
			HttpResponse response = mClient.execute(post);
			if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK && validateLogin()) {
				return true;
			}
		} catch (UnsupportedEncodingException e) {
			e.printStackTrace();
		} catch (ClientProtocolException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
		return false;
	}

2..获取书签列表(GET)

请求：https://www.google.com/bookmarks/?output=xml&sort=title&num=1000

参数说明：output：导出的方式xml/rss

sort：排序方式，title 以标题排序，date 以建立该Bookmark日期排序

Num：书签数量

若要添加，修改或删除书签，必须要通过https://www.google.com/bookmarks/?output=rss方式，获取响应实体，从中拿到sig签名数据，才能在修改书签时成功修改。

/**
	 * 获取服务器书签数据，获取sig参数
	 */
	private void getBookmarks() {
		HttpGet get = new HttpGet("https://www.google.com/bookmarks/lookup?output=rss");
		try {
			HttpResponse response = mClient.execute(get);
			if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
//				Log.d("getBookmarks", EntityUtils.toString(response.getEntity()));
				mSig= getSignature(response.getEntity().getContent());
				Log.d("getSignature", "mSig = "+mSig);
			}
		} catch (ClientProtocolException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

3.添加/修改书签(POST)

请求：https://www.google.com/bookmarks/mark

或https://www.google.com/bookmarks/mark?op=edited

或https://www.google.com/bookmarks/mark?op=

参数：sig=签名认证（获取书签列表时以https://www.google.com/bookmarks/lookup?output=rss获取时得到）

                  bkmk=URL
                  title=标题
                  labels=标签（可以为多个，以逗号隔开）
                  annotation=注解：

若书签已存在（URL相同），则修改服务器书签，完全覆盖（label被完全替换为传上去的标签）。

	/**
	 * 添加单个书签
	 */
	private void addBookmark() {
		HttpPost post = new HttpPost("https://www.google.com/bookmarks/mark");
		ArrayList<BasicNameValuePair> bnvps = new ArrayList<BasicNameValuePair>();
		bnvps.add(new BasicNameValuePair("bkmk","www.ceshi.com"));
		bnvps.add(new BasicNameValuePair("title","title_ceshi"));
		bnvps.add(new BasicNameValuePair("annotation","anno_ceshi"));
		bnvps.add(new BasicNameValuePair("labels","label_ceshi"));
		try {
			post.setEntity(new UrlEncodedFormEntity(bnvps));
			mClient.execute(post);
		} catch (UnsupportedEncodingException e) {
			e.printStackTrace();
		} catch (ClientProtocolException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

4.批量添加/修改书签（POST）

请求：https://www.google.com/bookmarks/mark?op=upload_selection&sig=签名字符串

参数：bm_序号="X"

url_序号=URL

ttl_序号=标题

lbl_序号=标签

参数中可添加多个书签，以序号区别，例：

bm_1=X,url_1=www.shuqian1.com,ttl_1=书签1,lbl_1=标签1

bm_2=X,url_2=www.shuqian2.com,ttl_2=书签2,lbl_2=标签2

此接口特性：若书签已存在，则修改服务器书签，但并不覆盖（若服务器书签有label，则上传的label会被加载已有label的后面）

/**
	 * 批量添加多个书签
	 */
	private void batchAddBookmarks() {
		HttpPost post = new HttpPost("https://www.google.com/bookmarks/mark?op=upload_selection&sig="+mSig);
		ArrayList<BasicNameValuePair> bnvps = new ArrayList<BasicNameValuePair>();
		
		bnvps.add(new BasicNameValuePair("bm_1","X"));
		bnvps.add(new BasicNameValuePair("url_1","www.ceshi1.com"));
		bnvps.add(new BasicNameValuePair("ttl_1","ceshi1"));
		bnvps.add(new BasicNameValuePair("lbl_1","111"));
		
		bnvps.add(new BasicNameValuePair("bm_2","X"));
		bnvps.add(new BasicNameValuePair("url_2","www.ceshi2.com"));
		bnvps.add(new BasicNameValuePair("ttl_2","ceshi2"));
		bnvps.add(new BasicNameValuePair("lbl_2","222"));
		try {
			post.setEntity(new UrlEncodedFormEntity(bnvps));
			mClient.execute(post);
		} catch (UnsupportedEncodingException e) {
			e.printStackTrace();
		} catch (ClientProtocolException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

5.删除书签（GET）

请求：https://www.google.com/bookmarks/mark?dlq=书签Id&sig=签名字符串

获取书签时以output=xml请求到的数据里有书签id信息。

/**
	 * 删除书签
	 */
	private void deleteBookmark() {
		HttpGet get = new HttpGet("https://www.google.com/bookmarks/mark?dlq=书签id&sig="+mSig);
		try {
			mClient.execute(get);
		} catch (UnsupportedEncodingException e) {
			e.printStackTrace();
		} catch (ClientProtocolException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

总结

1.必须获取到cookie信息后才能正确调用bookmark接口（详见登录google账户）

2.上述接口调用时httpClient用的是同一个对象，里面有cookie信息

3.Sig签名的获取：详见获取书签列表

4.bookmark的接口必须为https类型

参考资料

1.http://www.bookmarked.mobi/bm/google_bookmarks_api/

2.http://chuiwenchiu.spaces.live.com/blog/cns!CA5D9227DF9E78E8!860.entry

3.http://www.codeproject.com/KB/IP/GoogleBookmarks.aspx