正文  第三方集成 > 微博 >

腾讯微博java(android) api

由于现在腾讯微博提供的java(android) sdk功能过弱,自己搞了个java sdk包,同样适用于android。包含腾讯微博目前提供的95%的api,几乎所有主要功能api,用法简单。下面介绍源码地址和jar包地址,然后介绍api的......

由于现在腾讯微博提供的java(android) sdk功能过弱,自己搞了个java sdk包,同样适用于android。包含腾讯微博目前提供的95%的api,几乎所有主要功能api,用法简单。

 

下面介绍源码地址和jar包地址,然后介绍api的具体使用

1、源码和jar包下载

QqTAndroidSdk-1.0.0.jar为sdk主代码,其中的QqTSdkServiceImpl包含了所有接口的实现,下面第二部分对此中接口进行介绍

jar包地址:QqTAndroidSdk-1.0.0.jar

google code源码地址:https://code.google.com/p/qq-t-java-sdk/source/browse/

github源码地址:https://github.com/Trinea/qq-t-java-sdk

 

JavaCommon-1.0.0.jar为QqTAndroidSdk依赖的公用处理包,包含字符串、list、数组、map、json工具类等等

jar包地址:已经包含在QqTAndroidSdk-1.0.0.jar中

google code源码地址:http://code.google.com/p/trinea-java-common/source/browse/

github源码地址:https://github.com/Trinea/java-common

 

2、具体使用

参数同腾讯微博api http://wiki.open.t.qq.com/index.php/API%E6%96%87%E6%A1%A3

注意:以下所有的api示例代码都需要先新建QqTSdkService类对象并初始化,初始化如下

/**
 * 分别设置应用的key、secret(腾讯提供)。用户的accesstoken和tokenSecret(OAuth获取)
 * 请用自己的相应字符串替换,否则无法成功发送和获取数据
 **/
QqTAppAndToken qqTAppAndToken = new QqTAppAndToken();
qqTAppAndToken.setAppKey("***"); // ***用应用key替换
qqTAppAndToken.setAppSecret("***"); // ***用应用secret替换
qqTAppAndToken.setAccessToken("***"); // ***用用户accesstoken替换
qqTAppAndToken.setTokenSecret("***"); // ***用用户tokenSecret替换

/** 新建QqTSdkService对象,并设置应用信息和用户访问信息 **/
QqTSdkService qqTSdkService = new QqTSdkServiceImpl();
qqTSdkService.setQqTAppAndToken(qqTAppAndToken);

 

下面就对接口进行介绍,并举例如何使用QqTAndroidSdk-1.0.0.jar中的api,接口主要分成几大类:

2.1、时间线(微博列表)

这20个接口包含了腾讯微博四部分api

1.1、时间线中的除statuses/ht_timeline_ext(话题时间线)以外的15个api

1.2、私信相关中的收件箱、发件箱两个api

1.3、数据收藏中的收藏的微博列表和获取已订阅话题列表两个api

1.4、微博相关中的获取单条微博的转发或点评列表api

以获取首页信息为例,示例代码如下:

QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();
/** 设置分页标识 **/
qqTTimelinePara.setPageFlag(0);
/** 设置起始时间 **/
qqTTimelinePara.setPageTime(0);
/** 每次请求记录的条数 **/
qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);
/** 可以设置拉取类型,可取值QqTConstant中VALUE_STATUS_TYPE_TL_… **/
qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ALL);
/** 可以设置微博内容类型,可取值QqTConstant中VALUE_CONTENT_TYPE_TL… **/
qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_ALL);
List<QqTStatus> qqTStatusList = qqTSdkService.getHomeTL(qqTTimelinePara);
assertTrue(qqTStatusList != null);

 

这样qqTStatusList就保存了首页的20条数据,可以自己设置不同的类型参数

更多时间线数据获取见:腾讯微博java(android)sdk时间线api详细介绍

 

2.2、新增微博api

8个接口包含了

2.1、微博相关中的发表一条微博、转播一条微博、回复一条微博、发表一条带图片微博、点评一条微博、发表音乐微博、发表视频微博、发表心情帖子。在api中发表一条微博和发表一条带图片微博合二为一。

2.2、私信相关中的发私信api

以新增一条微博为例,示例代码如下

qqTSdkService.addStatus("第一条状态哦", null);

其找第一个参数为状态内容,第二个参数为图片地址,不传图片为空即可

或者复杂点的如下,status可以设置其他地理位置信息等

QqTStatusInfoPara status = new QqTStatusInfoPara();
status.setStatusContent("发表一条带图片微博啦");
/** 发表带图微博,设置图片路径 **/
status.setImageFilePath("/mnt/sdcard/DCIM/Camera/IMAG2150.jpg");
assertTrue(qqTSdkService.addStatus(status, qqTAppAndToken));

 

更多新增微博api介绍见:腾讯微博java(android)sdk新增微博api详细介绍

 

2.3、操作一条微博

这6个接口包含了腾讯微博三部分api

1.1、微博相关中的删除一条微博api。

1.2、私信相关中的删除私信api

1.3、数据收藏中收藏微博、取消收藏微博、订阅话题、取消订阅话题4个api

以收藏一条微博为例,示例代码如下

qqTSdkService.collect(12121); 

其中参数为微博id

更多操作微博相关api介绍见: 腾讯微博java(android)sdk操作(删除.收藏.订阅等)微博api详细介绍

 

2.4、关系链列表(用户列表)

这10个接口包含了腾讯微博关系链相关中的互听关系链列表(对某个用户而言,既是他的听众又被他收听)、其他帐号听众列表、其他帐号收听的人列表、其他帐户特别收听的人列表、黑名单列表、我的听众列表、我的听众列表(只包含名字)、我收听的人列表、我收听的人列表(只包含名字)、我的特别收听列表10个api

以获取自己的收听用户为例,示例代码如下

QqTUserRelationPara qqTUserRelationPara = new QqTUserRelationPara();
qqTUserRelationPara.setReqNumber(QqTConstant.VALUE_PAGE_REQ_NUM);
qqTUserRelationPara.setStartIndex(0);
List<QqTUser> qqTUserList = qqTSdkService.getSelfInterested(qqTUserRelationPara);
这样 qqTUserList就保存了自己的20位收听的用户信息
更多关系链列表相关api介绍见: 腾讯微博java(android)sdk关系链列表api详细介绍

 

2.5、用户建立关系

这6个接口包含了腾讯微博关系链相关中的收听某个用户、取消收听某个用户、特别收听某个用户、取消特别收听某个用户、添加某个用户到黑名单、从黑名单中删除某个用户共6个api

以关注某些用户为例,示例代码如下:

qqTSdkService.interestedInOther("wenzhang,li_nian,mayili007", null)

2.6、帐户相关

这7个接口包含了腾讯微博帐户相关中的获取自己的详细资料、更新用户信息、更新用户头像信息、更新用户教育信息、获取其他人资料、获取一批人的简单资料、验证账户是否合法(是否注册微博)共7个api。除获取心情微博api外

以获取自己的资料为例,示例代码如下:

QqTUser qqTUser = qqTSdkService.getSelfInfo();

2.7 搜索相关

这3个接口包含了腾讯微博搜索相关中的搜索用户、搜索微博、通过标签搜索用户共3个api。

以搜索微博为例,示例代码如下:

    public void testSearchStatus() {
        QqTSearchPara qqTSearchPara = new QqTSearchPara();
        qqTSearchPara.setKeyword("iphone");
        qqTSearchPara.setPage(1);
        qqTSearchPara.setPageSize(QqTConstant.VALUE_PAGE_REQ_NUM);
        List<QqTStatus> qqTStatusList = qqTSdkService.searchStatus(qqTSearchPara);
        assertTrue(qqTStatusList != null);
    }
 

 

2.8 热度趋势相关

这2个接口包含了腾讯微博热度趋势中的话题热榜、转播热榜用户共2个api。

以话题热榜为例,示例代码如下:

    public void testGetHotTopics() {
        QqTHotStatusPara qqTHotStatusPara = new QqTHotStatusPara();
        qqTHotStatusPara.setReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);
        qqTHotStatusPara.setLastPosition(0);
        /**
         * 1 话题名,2 搜索关键字 3 两种类型都有
         **/
        qqTHotStatusPara.setType(Integer.toString(1));
        List<QqTTopicSimple> hotTopicsList = qqTSdkService.getHotTopics(qqTHotStatusPara);
        assertTrue(hotTopicsList != null);
    }

 

2.9 数据更新相关

这1个接口为腾讯微博数据更新相关中的查看数据更新条数api。

示例代码如下:

    public void testGetUpdateInfoNum() {
        /** 设置clearType,对应QqTConstant.VALUE_CLEAR_TYPE_… **/
        QqTUpdateNumInfo qqTUpdateNumInfo = qqTSdkService.getUpdateInfoNum(true, QqTConstant.VALUE_CLEAR_TYPE_HOME_PAGE);
        assertTrue(qqTUpdateNumInfo != null);
    }

 

2.10 话题相关

这2个接口为腾讯微博话题相关中的根据话题名称查询话题id和根据话题id获取话题相关信息api。

示例代码如下:

    public void testGetTopicInfoByIds() {
        /** 先得到话题id **/
        Map<String, String> topicIdAndName = qqTSdkService.getTopicIdByNames("袁莉闪婚,美汁源下架,iphone");

        if (topicIdAndName != null) {
            /** 话题id列表,以逗号分隔 **/
            List<QqTStatus> qqtStatusList = qqTSdkService.getTopicInfoByIds(ListUtils.join(new ArrayList<String>(topicIdAndName.keySet())));
            assertTrue(qqtStatusList != null);
        } else {
            assertTrue(false);
        }
    }

 

以上代码为先根据话题名得到话题id列表,然后为根据话题id获取话题相关信息接口,参数为话题id列表,以逗号分隔

2.11 标签相关

这2个接口为腾讯微博标签相关中的添加标签和删除标签api。

    public void testDeleteTag() {
        /** 删除自己的tag,先获取自己的资料,从中取中tag id **/
        QqTUser qqTUser = qqTSdkService.getSelfInfo();
        if (qqTUser != null && qqTUser.getTagMap() != null && qqTUser.getTagMap().size() > 0) {
            /** 删除tag **/
            for (Map.Entry<String, String> tag : qqTUser.getTagMap().entrySet()) {
                qqTSdkService.deleteTag(tag.getKey());
            }
        } else {
            assertTrue(false);
        }
    }