Class: Weibo2::Interface::Search

Inherits:
Base
  • Object
show all
Defined in:
lib/weibo2/interface/search.rb

Overview

Search API

See Also:

Instance Method Summary collapse

Methods inherited from Base

#get, #initialize, #post, #request

Constructor Details

This class inherits a constructor from Weibo2::Interface::Base

Instance Method Details

#geo_statuses(longitude, latitude, opts = {}) ⇒ Object

获取指定地点周边的微博列表 [Privilege]

Parameters:

  • longitude (float) —

    经度。有效范围：-180.0到180.0，表示东经

  • latitude (float) —

    纬度。有效范围：-90.0到90.0，表示北纬

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :range (int) —

    搜索范围，单位米，默认500米，最大11132米

  • :time (int) —

    返回结果所在的时间段，单位为分钟，指从现在开始之前的时间段

  • :sort_type (int) —

    排序方式。默认为0，按时间排序；为1时按与中心点距离进行排序

  • :page (int) —

    返回结果页码。默认为1

  • :count (int) —

    每页结果数。默认10，最大50

  • :base_app (int) —

    是否根据当前应用返回数据。默认0：全部应用；1：仅限当前应用

See Also:



130
131
132
 
# File 'lib/weibo2/interface/search.rb', line 130

def geo_statuses(longitude, latitude, opts={})
  get 'search/geo/statuses.json', :params => {:longitude => longitude, :latitude => latitude}.merge(opts)
end

#statuses(opts = {}) ⇒ Object

搜索与指定的一个或多个条件相匹配的微博 [Privilege]

Parameters:

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :q (String) —

    搜索的关键字

  • :filter_ori (int) —

    过滤器，是否为原创，0：全部、1：原创、2：转发，默认为0

  • :filter_pic (int) —

    过滤器。是否包含图片，0：全部、1：包含、2：不包含，默认为0

  • :fuid (int64) —

    搜索的微博作者的用户UID

  • :province (int) —

    搜索的省份范围，省份ID

  • :city (int) —

    搜索的城市范围，城市ID

  • :starttime (int64) —

    开始时间，Unix时间戳

  • :endtime (int64) —

    结束时间，Unix时间戳

  • :count (int) —

    单页返回的记录条数，默认为10

  • :page (int) —

    返回结果的页码，默认为1

  • :needcount (boolean) —

    返回结果中是否包含返回记录数，true：返回、false：不返回，默认为false

  • :base_app (int) —

    是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0

See Also:



113
114
115
 
# File 'lib/weibo2/interface/search.rb', line 113

def statuses(opts={})
  get 'search/statuses.json', :params => opts
end

#suggestions_apps(q, opts = {}) ⇒ Object

搜索应用时的联想搜索建议

Parameters:

  • q (String) —

    搜索的关键字

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :count (int) —

    返回的记录条数，默认为10

See Also:



62
63
64
 
# File 'lib/weibo2/interface/search.rb', line 62

def suggestions_apps(q, opts={})
  get 'search/suggestions/apps.json', :params => {:q => q}.merge(opts)
end

#suggestions_at_users(q, type, opts = {}) ⇒ Object

@用户时的联想建议

Parameters:

  • q (String) —

    搜索的关键字

  • type (int) —

    联想类型，0：关注、1：粉丝

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :count (int) —

    返回的记录条数，默认为10，粉丝最多1000，关注最多2000

  • :range (int) —

    联想范围，0：只联想关注人、1：只联想关注人的备注、2：全部，默认为2

See Also:



75
76
77
 
# File 'lib/weibo2/interface/search.rb', line 75

def suggestions_at_users(q, type, opts={})
  get 'search/suggestions/at_users.json', :params => {:q => q, :type => type}.merge(opts)
end

#suggestions_companies(q, opts = {}) ⇒ Object

搜索公司时的联想搜索建议

Parameters:

  • q (String) —

    搜索的关键字

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :count (int) —

    返回的记录条数，默认为10

See Also:



51
52
53
 
# File 'lib/weibo2/interface/search.rb', line 51

def suggestions_companies(q, opts={})
  get 'search/suggestions/companies.json', :params => {:q => q}.merge(opts)
end

#suggestions_integrate(q, opts = {}) ⇒ Object

TODO:test no pass 综合联想，包含用户、微群、应用等的联想建议

Parameters:

  • query (String) —

    搜索的关键字

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :sort_user (int) —

    用户排序，0：按专注人最多，默认为0

  • :sort_app (int) —

    应用排序，0：按用户数最多，默认为0

  • :sort_grp (int) —

    微群排序，0：按成员数最多，默认为0

  • :user_count (int) —

    返回的用户记录条数，默认为4

  • :app_count (int) —

    返回的应用记录条数，默认为1

  • :grp_count (int) —

    返回的微群记录条数，默认为1

See Also:



92
93
94
 
# File 'lib/weibo2/interface/search.rb', line 92

def suggestions_integrate(q, opts={})
  get 'search/suggestions/integrate.json', :params => {:query => q}.merge(opts)
end

#suggestions_schools(q, opts = {}) ⇒ Object

搜索学校时的联想搜索建议

Parameters:

  • q (String) —

    搜索的关键字

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :count (int) —

    返回的记录条数，默认为10

  • :type (int) —

    学校类型，0：全部、1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为0

See Also:



40
41
42
 
# File 'lib/weibo2/interface/search.rb', line 40

def suggestions_schools(q, opts={})
  get 'search/suggestions/schools.json', :params => {:q => q}.merge(opts)
end

#suggestions_statuses(q, opts = {}) ⇒ Object

搜索微博时的联想搜索建议

Parameters:

  • q (String) —

    搜索的关键字

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :count (int) —

    返回的记录条数，默认为10

See Also:



28
29
30
 
# File 'lib/weibo2/interface/search.rb', line 28

def suggestions_statuses(q, opts={})
  get 'search/suggestions/statuses.json', :params => {:q => q}.merge(opts)
end

#suggestions_users(q, opts = {}) ⇒ Object

搜索用户时的联想搜索建议

Parameters:

  • q (String) —

    搜索的关键字

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :count (int) —

    返回的记录条数，默认为10

See Also:



17
18
19
 
# File 'lib/weibo2/interface/search.rb', line 17

def suggestions_users(q, opts={})
  get 'search/suggestions/users.json', :params => {:q => q}.merge(opts)
end

#users(opts = {}) ⇒ Object

通过关键词搜索用户 [Privilege]

Parameters:

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :q (String) —

    搜索的关键字

  • :snick (int) —

    搜索范围是否包含昵称，0：不包含、1：包含

  • :sdomain (int) —

    搜索范围是否包含个性域名，0：不包含、1：包含

  • :sintro (int) —

    搜索范围是否包含简介，0：不包含、1：包含

  • :stag (int) —

    搜索范围是否包含标签，0：不包含、1：包含

  • :province (int) —

    搜索的省份范围，省份ID

  • :city (int) —

    搜索的城市范围，城市ID

  • :gender (String) —

    搜索的性别范围，m：男、f：女

  • :comorsch (String) —

    搜索的公司学校名称

  • :sort (int) —

    排序方式，1：按更新时间、2：按粉丝数，默认为1

  • :count (int) —

    单页返回的记录条数，默认为10

  • :page (int) —

    返回结果的页码，默认为1

  • :base_app (int) —

    是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0

See Also:



152
153
154
 
# File 'lib/weibo2/interface/search.rb', line 152

def users(opts={})
  get 'search/users.json', :params => opts
end