Class: Weibo2::Interface::Account

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

Overview

Account 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

#avatar_upload(image) ⇒ Object

no test 更新当前登录用户的头像 [Privilege]

Parameters:

  • image (binary) —

    头像图片，仅支持JPEG、GIF、PNG格式，图片大小小于5M.必须使用multipart/form-data方式提交

See Also:



185
186
187
 
# File 'lib/weibo2/interface/account.rb', line 185

def avatar_upload(image)
  post 'account/avatar/upload.json', :body => {:image => image}
end

#get_privacy ⇒ Object

获取当前登录用户的隐私设置

See Also:



61
62
63
 
# File 'lib/weibo2/interface/account.rb', line 61

def get_privacy
  get 'account/get_privacy.json'
end

#get_uid ⇒ Object

OAuth授权之后，获取授权用户的UID

See Also:



91
92
93
 
# File 'lib/weibo2/interface/account.rb', line 91

def get_uid
  get 'account/get_uid.json'
end

#profile_basic(opts = {}) ⇒ Object

获取用户基本信息 [Privilege]

Parameters:

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

Options Hash (opts):

  • :uid (int64) —

    需要获取基本信息的用户UID，默认为当前登录用户

See Also:



16
17
18
 
# File 'lib/weibo2/interface/account.rb', line 16

def profile_basic(opts={})
  get 'account/profile/basic.json', :params => opts
end

#profile_basic_update(screen_name, province, city, gender, opts = {}) ⇒ Object

更新用户的基本信息 [Privilege]

Parameters:

  • screen_name (String) —

    用户昵称，不可为空

  • province (int) —

    省份代码ID，不可为空

  • city (int) —

    城市代码ID，不可为空

  • gender (String) —

    用户性别，m：男、f：女，不可为空

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

Options Hash (opts):

  • :real_name (String) —

    用户真实姓名

  • :real_name_visible (int) —

    真实姓名可见范围，0：自己可见、1：关注人可见、2：所有人可见

  • :birthday (date) —

    用户生日，格式：yyyy-mm-dd

  • :birthday_visible (int) —

    生日可见范围，0：保密、1：只显示月日、2：只显示星座、3：所有人可见

  • :qq (String) —

    用户QQ号码

  • :qq_visible (int) —

    用户QQ可见范围，0：自己可见、1：关注人可见、2：所有人可见

  • :msn (String) —

    用户MSN

  • :msn_visible (int) —

    用户MSN可见范围，0：自己可见、1：关注人可见、2：所有人可见

  • :url (String) —

    用户博客地址

  • :url_visible (int) —

    用户博客地址可见范围，0：自己可见、1：关注人可见、2：所有人可见

  • :credentials_type (int) —

    证件类型，1：身份证、2：学生证、3：军官证、4：护照

  • :credentials_num (String) —

    证件号码

  • :email (String) —

    用户常用邮箱地址

  • :email_visible (int) —

    用户常用邮箱地址可见范围，0：自己可见、1：关注人可见、2：所有人可见

  • :lang (String) —

    语言版本，zh_cn：简体中文、zh_tw：繁体中文

  • :description (String) —

    用户描述，最长不超过70个汉字

See Also:



124
125
126
127
 
# File 'lib/weibo2/interface/account.rb', line 124

def profile_basic_update(screen_name, province, city, gender, opts={})
  body = {:screen_name => screen_name, :province => province, :city => city, :gender => gender}.merge(opts)
  post 'account/profile/basic_update.json', :body => body
end

#profile_car_destroy(id) ⇒ Object

根据公司ID删除用户的职业信息 [Privilege]

Parameters:

  • id (int64) —

    职业信息里的公司ID

See Also:



175
176
177
 
# File 'lib/weibo2/interface/account.rb', line 175

def profile_car_destroy(id)
  post 'account/profile/car_destroy.json', :body => {:id => id}
end

#profile_car_update(opts) ⇒ Object

更新当前登录用户的职业信息 [Privilege]

Parameters:

  • opts (Hash)

Options Hash (opts):

  • :id (String) —

    需要更新的职业信息ID

  • :start (int) —

    进入公司年份，最小为1900，最大为当年年份

  • :end (int) —

    离开公司年份，至今填0

  • :department (String) —

    工作部门

  • :visible (int) —

    可见范围，0：自己可见、1：关注人可见、2：所有人可见

  • :province (int) —

    省份代码ID，不可为空值

  • :city (int) —

    城市代码ID，不可为空值

  • :company (String) —

    公司名称，不可为空值

See Also:



166
167
168
 
# File 'lib/weibo2/interface/account.rb', line 166

def profile_car_update(opts)
  post 'account/profile/car_update.json', :body => opts
end

#profile_career(opts = {}) ⇒ Object

获取用户的职业信息 [Privilege]

Parameters:

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

Options Hash (opts):

  • :uid (int64) —

    需要获取教育信息的用户UID，默认为当前登录用户

See Also:



45
46
47
 
# File 'lib/weibo2/interface/account.rb', line 45

def profile_career(opts={})
  get 'account/profile/career.json', :params => opts
end

#profile_career_batch(uids) ⇒ Object

批量获取用户的职业信息 [Privilege]

Parameters:

  • uids (String) —

    需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20

See Also:



54
55
56
 
# File 'lib/weibo2/interface/account.rb', line 54

def profile_career_batch(uids)
  get 'account/profile/career_batch.json', :params => uids
end

#profile_edu_destroy(id) ⇒ Object

根据学校ID删除用户的教育信息 [Privilege]

Parameters:

  • id (int64) —

    教育信息里的学校ID

See Also:



149
150
151
 
# File 'lib/weibo2/interface/account.rb', line 149

def profile_edu_destroy(id)
  post 'account/profile/edu_destroy.json', :body => {:id => id}
end

#profile_edu_update(type, school_id, opts = {}) ⇒ Object

更新当前登录用户的教育信息 [Privilege]

Parameters:

  • type (int) —

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

  • school_id (int) —

    学校代码

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

Options Hash (opts):

  • :id (String) —

    需要修改的教育信息ID，不传则为新建，传则为更新

  • :year (int) —

    入学年份，最小为1900，最大不超过当前年份

  • :department (String) —

    院系或者班别

  • :visible (int) —

    开放等级，0：仅自己可见、1：关注的人可见、2：所有人可见

See Also:



140
141
142
 
# File 'lib/weibo2/interface/account.rb', line 140

def profile_edu_update(type, school_id, opts={})
  post 'account/profile/edu_update.json', :body => {:type => type, :school_id => school_id}.merge(opts)
end

#profile_education(opts = {}) ⇒ Object

获取用户的教育信息 [Privilege]

Parameters:

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

Options Hash (opts):

  • :uid (int64) —

    需要获取教育信息的用户UID，默认为当前登录用户

See Also:



26
27
28
 
# File 'lib/weibo2/interface/account.rb', line 26

def profile_education(opts={})
  get 'account/profile/education.json', :params => opts
end

#profile_education_batch(uids) ⇒ Object

批量获取用户的教育信息 [Privilege]

Parameters:

  • uids (String) —

    需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20

See Also:



35
36
37
 
# File 'lib/weibo2/interface/account.rb', line 35

def profile_education_batch(uids)
  get 'account/profile/education_batch.json', :params => {:uids => uids}
end

#profile_school_list(opts = {}) ⇒ Object

获取所有的学校列表

Parameters:

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

Options Hash (opts):

  • :province (int) —

    省份范围，省份ID

  • :city (int) —

    城市范围，城市ID

  • :area (int) —

    区域范围，区ID

  • :type (int) —

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

  • :capital (String) —

    学校首字母，默认为A

  • :keyword (String) —

    学校名称关键字

  • :count (int) —

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

See Also:



77
78
79
 
# File 'lib/weibo2/interface/account.rb', line 77

def profile_school_list(opts={})
  get 'account/profile/school_list.json', :params => opts
end

#rate_limit_status ⇒ Object

获取当前登录用户的API访问频率限制情况

See Also:



84
85
86
 
# File 'lib/weibo2/interface/account.rb', line 84

def rate_limit_status
  get 'account/rate_limit_status.json'
end

#update_privacy(opts = {}) ⇒ Object

更新当前登录用户的隐私设置 [Privilege]

Parameters:

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

Options Hash (opts):

  • :comment (int) —

    是否可以评论我的微博，0：所有人、1：关注的人，默认为0

  • :geo (int) —

    是否开启地理信息，0：不开启、1：开启，默认为1

  • :message (int) —

    是否可以给我发私信，0：所有人、1：关注的人，默认为0

  • :realname (int) —

    是否可以通过真名搜索到我，0：不可以、1：可以，默认为0

  • :badge (int) —

    勋章是否可见，0：不可见、1：可见，默认为1

  • :mobile (int) —

    是否可以通过手机号码搜索到我，0：不可以、1：可以，默认为0

See Also:



200
201
202
 
# File 'lib/weibo2/interface/account.rb', line 200

def update_privacy(opts={})
  post 'account/update_privacy.json', :body => opts
end