QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第四期]

于 2024-09-11 10:17:08 发布
阅读量420 收藏 10
点赞数 16
分类专栏： QQ机器人开发 文章标签： 机器人
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_71745595/article/details/142111946
版权

QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第四期]

第四期介绍：频道模块之频道身份组与权限管理

目录

在这里插入图片描述

不懂得的也可以来私聊或评论区问哦～
在这里插入图片描述
原力到一千才可以推广，三连啊喂！！！

在这里插入图片描述

获取频道身份组列表

接口
GET /guilds/{guild_id}/roles

功能描述
用于获取 guild_id 指定的频道下的身份组列表。

Content-Type
application/json

返回

字段名类型描述
guild_idstring频道 ID
rolesRole 对象数组一组频道身份组对象
role_num_limitstring默认分组上限

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/roles"
Authorization = f"QQBot {你的鉴权}"

}
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()

print(response)

运行结果如下：

{
  "guild_id": "123456",
  "roles": [
    {
      "id": "4",
      "name": "创建者",
      "color": 4294927682,
      "hoist": 1,
      "number": 1,
      "member_limit": 1
    },
    {
      "id": "2",
      "name": "管理员",
      "color": 4280276644,
      "hoist": 1,
      "number": 5,
      "member_limit": 50
    }
  ],
  "role_num_limit": "30"
}

在这里插入图片描述

创建频道身份组

接口
POST /guilds/{guild_id}/roles

功能描述
用于在 guild_id 指定的频道下创建一个身份组。

  • 需要使用的 token 对应的用户具备创建身份组权限。如果是机器人，要求被添加为管理员。
  • 参数为非必填，但至少需要传其中之一，默认为空或 0。

Content-Type
application/json

参数

字段名类型描述
namestring名称(非必填)
coloruint32ARGB 的 HEX 十六进制颜色值转换后的十进制数值(非必填)
hoistint32在成员列表中单独展示: 0-否, 1-是(非必填)

返回

字段名类型描述
role_idstring身份组 ID
roleRole 对象所创建的频道身份组对象

错误码
详见 错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/roles"
Authorization = f"QQBot {你的鉴权}"

data = {
  "name": "test",
  "color": 99999,
  "hoist": "1"
}

}
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.post(url, headers=herders, json=data).json()

print(response)

运行结果如下：

{
  "role_id": "10177739",
  "role": {
    "id": "10177739",
    "name": "test",
    "color": 99999,
    "hoist": 1,
    "number": 0,
    "member_limit": 2000
  }
}

在这里插入图片描述

修改频道身份组

接口

PATCH /guilds/{guild_id}/roles/{role_id}

功能描述
用于修改频道 guild_id 下 role_id 指定的身份组。

  • 需要使用的 token 对应的用户具备修改身份组权限。如果是机器人，要求被添加为管理员。
  • 接口会修改传入的字段，不传入的默认不会修改，至少要传入一个参数。

Content-Type
application/json

参数

字段名类型描述
namestring名称(非必填)
coloruint32ARGB 的 HEX 十六进制颜色值转换后的十进制数值(非必填)
hoistint32在成员列表中单独展示: 0-否, 1-是(非必填)

返回

字段名类型描述
guild_idstring频道 ID
role_idstring身份组 ID
roleRole 对象修改后的频道身份组对象

错误码
详见 错误码。

Python示例

import requests

# 替换为你的guild_id和role_id
guild_id = "你的频道ID"
role_id = "你的身份组ID"
url = f"https://api.sgroup.qq.com/guilds/{guild_id}/roles/{role_id}"
Authorization = f"QQBot 你的鉴权token"

data = {
  "name": "test",
  "color": 99999,
  "hoist": 1
}

headers = {
    "Content-Type": "application/json",
    "Authorization": Authorization
}

response = requests.patch(url, headers=headers, json=data).json()

print(response)

请求数据包

{
  "name": "test",
  "color": 99999,
  "hoist": 1
}

响应数据包

{
  "guild_id": "3489223429684602178",
  "role_id": "10177739",
  "role": {
    "id": "10177739",
    "name": "test",
    "color": 99999,
    "hoist": 1,
    "number": 1,
    "member_limit": 2000
  }
}

在这里插入图片描述

删除频道身份组

接口

DELETE /guilds/{guild_id}/roles/{role_id}

功能描述
用于删除频道 guild_id 下 role_id 对应的身份组。

  • 需要使用的 token 对应的用户具备删除身份组权限。如果是机器人，要求被添加为管理员。

Content-Type
application/json

返回
成功返回 HTTP 状态码 204。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的guild_id和role_id
guild_id = "你的频道ID"
role_id = "你的身份组ID"
url = f"https://api.sgroup.qq.com/guilds/{guild_id}/roles/{role_id}"
Authorization = f"QQBot 你的鉴权token"

headers = {
    "Authorization": Authorization
}

response = requests.delete(url, headers=headers)

if response.status_code == 204:
    print("身份组删除成功")
else:
    print("删除身份组失败，状态码：", response.status_code)

请求数据包

DELETE /guilds/123456/roles/112233

在这里插入图片描述

创建频道身份组成员

接口

PUT /guilds/{guild_id}/members/{user_id}/roles/{role_id}

功能描述
用于将频道 guild_id 下的用户 user_id 添加到身份组 role_id。

  • 需要使用的 token 对应的用户具备增加身份组成员权限。如果是机器人，要求被添加为管理员。
  • 如果要增加的身份组 ID 是 5-子频道管理员，需要增加 channel 对象来指定具体是哪个子频道。

Content-Type
application/json

参数

字段名类型描述
channelChannel 对象接收一个只填充了子频道 id 字段的对象

返回
成功返回 HTTP 状态码 204。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的guild_id, user_id和role_id
guild_id = "你的频道ID"
user_id = "你的用户ID"
role_id = "你的身份组ID"
url = f"https://api.sgroup.qq.com/guilds/{guild_id}/members/{user_id}/roles/{role_id}"
Authorization = f"QQBot 你的鉴权token"

data = {
  "channel": {
    "id": "子频道ID"
  }
}

headers = {
    "Content-Type": "application/json",
    "Authorization": Authorization
}

response = requests.put(url, headers=headers, json=data)

if response.status_code == 204:
    print("用户成功添加到身份组")
else:
    print("添加用户到身份组失败，状态码：", response.status_code)

请求数据包

{
  "channel": {
    "id": "1744939"
  }
}

在这里插入图片描述

删除频道身份组成员

接口

DELETE /guilds/{guild_id}/members/{user_id}/roles/{role_id}

功能描述
用于将用户 user_id 从频道 guild_id 的 role_id 身份组中移除。

  • 需要使用的 token 对应的用户具备删除身份组成员权限。如果是机器人，要求被添加为管理员。
  • 如果要删除的身份组 ID 是 5-子频道管理员，需要增加 channel 对象来指定具体是哪个子频道。

Content-Type
application/json

参数

字段名类型描述
channelChannel 对象接收一个只填充了子频道 id 字段的对象

返回
成功返回 HTTP 状态码 204。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的guild_id, user_id和role_id
guild_id = "你的频道ID"
user_id = "你的用户ID"
role_id = "你的身份组ID"
url = f"https://api.sgroup.qq.com/guilds/{guild_id}/members/{user_id}/roles/{role_id}"
Authorization = f"QQBot 你的鉴权token"

headers = {
    "Authorization": Authorization
}

response = requests.delete(url, headers=headers)

if response.status_code == 204:
    print("用户成功从身份组移除")
else:
    print("移除用户从身份组失败，状态码：", response.status_code)

在这里插入图片描述

获取子频道用户权限

接口

GET /channels/{channel_id}/members/{user_id}/permissions

功能描述
用于获取子频道 channel_id 下用户 user_id 的权限。

  • 获取子频道用户权限。
  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。

Content-Type
application/json

返回
返回 ChannelPermissions 对象。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的channel_id和user_id
channel_id = "你的子频道ID"
user_id = "你的用户ID"
url = f"https://api.sgroup.qq.com/channels/{channel_id}/members/{user_id}/permissions"
Authorization = f"QQBot 你的鉴权token"

headers = {
    "Authorization": Authorization
}

response = requests.get(url, headers=headers)

permissions = response.json()
print("用户权限：", permissions)

在这里插入图片描述

修改子频道用户权限

接口

PUT /channels/{channel_id}/members/{user_id}/permissions

功能描述
用于修改子频道 channel_id 下用户 user_id 的权限。

  • 要求操作人具有 管理子频道 的权限，如果是机器人，则需要将机器人设置为管理员。
  • 参数包括 add 和 remove 两个字段，分别表示授予的权限以及删除的权限。要授予用户权限即把 add 对应位置 1，删除用户权限即把 remove 对应位置 1。当两个字段同一位都为 1，表现为删除权限。
  • 本接口不支持修改 可管理子频道 权限。

Content-Type
application/json

参数

字段名类型描述
addstring字符串形式的位图表示赋予用户的权限
removestring字符串形式的位图表示删除用户的权限

返回
成功返回 HTTP 状态码 204。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的channel_id和user_id
channel_id = "你的子频道ID"
user_id = "你的用户ID"
url = f"https://api.sgroup.qq.com/channels/{channel_id}/members/{user_id}/permissions"
Authorization = f"QQBot 你的鉴权token"

data = {
  "add": "1",
  "remove": "4"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": Authorization
}

response = requests.put(url, headers=headers, json=data)

if response.status_code == 204:
    print("用户权限修改成功")
else:
    print("修改用户权限失败，状态码：", response.status_code)

在这里插入图片描述

获取子频道身份组权限

接口

GET /channels/{channel_id}/roles/{role_id}/permissions

功能描述
用于获取子频道 channel_id 下身份组 role_id 的权限。

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。

Content-Type
application/json

返回
返回 ChannelPermissions 对象。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的channel_id和role_id
channel_id = "你的子频道ID"
role_id = "你的身份组ID"
url = f"https://api.sgroup.qq.com/channels/{channel_id}/roles/{role_id}/permissions"
Authorization = f"QQBot 你的鉴权token"

headers = {
    "Authorization": Authorization
}

response = requests.get(url, headers=headers)

permissions = response.json()
print("身份组权限：", permissions)

在这里插入图片描述

修改子频道身份组权限

接口

PUT /channels/{channel_id}/roles/{role_id}/permissions

功能描述
用于修改子频道 channel_id 下身份组 role_id 的权限。

  • 要求操作人具有 管理子频道 的权限，如果是机器人，则需要将机器人设置为管理员。
  • 参数包括 add 和 remove 两个字段，分别表示授予的权限以及删除的权限。要授予身份组权限即把 add 对应位置 1，删除身份组权限即把 remove 对应位置 1。当两个字段同一位都为 1，表现为删除权限。
  • 本接口不支持修改 可管理子频道 权限。

Content-Type
application/json

参数

字段名类型描述
addstring字符串形式的位图表示赋予用户的权限
removestring字符串形式的位图表示删除用户的权限

返回
成功返回 HTTP 状态码 204。

错误码
详见 错误码。

Python示例

import requests

# 替换为你的channel_id和role_id
channel_id = "你的子频道ID"
role_id = "你的身份组ID"
url = f"https://api.sgroup.qq.com/channels/{channel_id}/roles/{role_id}/permissions"
Authorization = f"QQBot 你的鉴权token"

data = {
  "add": "1",
  "remove": "4"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": Authorization
}

response = requests.put(url, headers=headers, json=data)

if response.status_code == 204:
    print("身份组权限修改成功")
else:
    print("修改身份组权限失败，状态码：", response.status_code)

在这里插入图片描述

致谢和更新

文章持续更新，如果三连支持，速更！！！
请在评论区提出疑惑和建议
上次更新: 9/11/2024, AM

在这里插入图片描述

⬅️QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第三期]
➡️第五期：频道模块之接口授权管理和发言管理(更新中…)

吃点李子
关注
  • 16
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]
qq_71745595的博客
09-09 1105
QQ频道机器人零基础开发详解第二期
QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第三期]
qq_71745595的博客
09-10 893
QQ频道机器人零基础开发详解第三期
QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第一期]
qq_71745595的博客
09-08 1335
QQ频道机器人零基础开发详解第一期
2024 年最新使用 Node 搭建QQ开放平台官方 QQ 频道机器人详细教程（更新中）
唤醒手腕
06-15 2457
QQ频道机器人是一种对QQ频道进行功能扩展的程序，通过开放的接口，让开发者能够实现开发出交互形式丰富的机器人，以辅助实现频道/社群内的管理、消息互动，满足频道主或群主运营者多样化、个性化的运营需求，从而提高运营效率，同时为用户带来丰富的服务和便捷的体验。资料提交成功后，即会生成 appid，点击对应的应用即可跳转管理端。
2023 版 QQ 机器人运行部署文档
是谢添啊
09-25 3184
QQ机器人框架，登录QQ机器人，消息处理，Linux 服务器持续运行 QQ 机器人，将手机与 linux 服务器处于同一网络，socks5，pbrq，pbbot-rq。问题解决：当前设备网络不稳定或处于夏杂网络环境，为了你的帐号安全，建议将两个设备连接同一网络或将被扫描设备连接你的手机热点后，重新扫码登录。
如何基于 Python 快速搭建 QQ 开放平台 QQ 群官方机器人详细教程（更新中）
唤醒手腕
06-13 4858
配置完成后，群主可从沙箱群“设置-群机器人”打开机器人列表页添加测试机器人进行开发调试。部分之前就注册的机器人可能不需要进行配置，但是新注册的机器人在进行腾讯开放平台的提审之前，需要进行 IP 白名单的配置。原机器人的老版本qq-bot仍然可以使用，但新接口的支持上会逐渐暂停，此次升级不会影响线上使用的机器人。QQ 机器人：一个机器人可以被添加到 群聊/频道 内对话，QQ 用户也可以直接跟机器人 单独对话。如需开发在QQ群使用的机器人功能请完成此项配置。注意：每个事件会下发具体的数据对象，如。
python开发qq聊天机器人_python3+qqBot+图灵机器人实现qq聊天机器人
weixin_39640221的博客
12-06 2292
原理：通过Python3的qqBot开源库，基于腾讯的smartQQ协议登录个人QQ，实现监控、收集QQ消息，进而通过图灵机器人API接入方式实现自动聊天。零、前期准备：1、Python32、qqBot & requests & re3、申请图灵机器人一、安装Python3的3个库：Windows下打开cmd命令提示符，进入python，尝试import导入一下库。若均已安装，则显...
Mirai QQ群机器人零基础教程（1）
m0_63754068的博客
06-01 3437
Mirai Console 是一个基于命令行界面的 QQ 机器人控制台，主要用于管理QQ群聊。界面简洁，插件丰富，安装简便。我已经使用了一个多月，但是功能还是很多都没有吃透，这里介绍一下安装方法，如果大家遇到问题可以在下面留言，我看到了会帮忙解决。如果按我的教程一步一步基本不会出问题。 感谢您下载IntelliJ IDEA！使用 IntelliJ IDEA 享受更高效的 Java 和 Kotlin 开发！https://www.jetbrains.com/zh-cn/idea/download/downlo
Python 基于 NoneBot 框架 Centos 云服务器端开发 QQ 机器人基础详细教程（更新中）
唤醒手腕
09-28 1746
官方地址NoneBot2 是一个可扩展的 Python 异步机器人框架，它会对机器人收到的事件进行解析和处理，并以插件化的形式，按优先级分发给事件所对应的事件响应器，来完成具体的功能。除了起到解析事件的作用，NoneBot 还为插件提供了大量实用的预设操作和权限控制机制。对于命令处理，它更是提供了完善且易用的会话机制和内部调用机制，以分别适应命令的连续交互和插件内部功能复用等需求。
傻妞教程——对接QQ频道机器人
blog.jichun29.cn
01-02 494
前往傻妞插件市场安装QQ频道机器人插件，基于Node开发。
PC9.6.2HIQQ机器人框架源码.zip
10-02
HIQQ机器人框架基于PC协议9.6.2构建，旨在简化QQ机器人的开发流程。该框架包含多种协议，每种协议对应特定的交互场景，如好友聊天、群聊、消息广播等。开发者可以根据需求选择合适的协议，快速实现所需功能。同时，...
基于JavaScript开发的QQ聊天机器人，支持二维码登录，群组讨论，消息派发，HTTP接口，qqbot等+源码+项目开发解析
06-01
基于JavaScript开发的QQ聊天机器人，支持二维码登录，群组讨论，消息派发，HTTP接口，qqbot等+源码+项目开发解析，基于JavaScript开发的QQ聊天机器人，支持二维码登录，群组讨论，消息派发，HTTP接口，qqbot等+源码+...
小白菜QQ云端机器人源码 去除解密授权学习版的原始代码
11-17
小白菜QQ云端机器人源码分享：解密授权学习版已去除 这款源码是专为群机器人爱好者设计的，它基于挂机宝机器人框架构建的网页站点。用户可以通过网页登录QQ账号至挂机宝框架中，无需通过机器人实现登录。而且，该...
基于C++实现QQ空间机器人.zip
03-03
QQ空间机器人是一个利用C++编程语言开发的自动化程序，它能模拟用户行为，对QQ空间中的新动态进行自动监控、评论和回复。这样的程序在社交网络自动化管理、数据分析或者个性化用户体验方面具有一定的应用价值。下面...
QQ频道机器人文档-bot-docs.zip
01-31
总之，QQ频道机器人文档-Bot-docs.zip为你提供了一个全面的指南，帮助你从零开始创建和管理自己的QQ频道机器人，提升频道的互动性和用户体验。无论你是编程新手还是有经验的开发者，这份文档都将是你宝贵的参考资料...
【机器人工具箱Robotics Toolbox开发笔记（十八）】SCARA机器人的gui界面：正运动学仿真实例
m0_72676510的博客
09-07 152
本文通过机器人工具箱实现SCARA机器人的GUI界面以进行正运动学分析，主要涉及到MATLAB的Robotics Toolbox以及GUI工具箱的使用。
论文速读|形机器人的高速和抗冲击远程操作
最新发布
2301_81924597的博客
09-10 82
本文提出了一种综合解决方案，用于远程控制类人机器人，实现了高速度和冲击抵抗的操作。通过结合无校准的运动捕捉和重定标、低延迟全身运动流式传输工具箱和高带宽的摆线驱动器，显著提高了机器人控制的透明度和同步性。实验结果表明，该系统在高速运动和冲击环境下表现出色，达到了前所未有的性能水平。
智能巡检机器人创新设计的关键技术
Chaoweijiqiren的博客
09-05 923
然而，为了应对复杂的应用环境和不断变化的需求，智能巡检机器人在设计中必须采用一系列关键技术创新，确保其具备高效、灵活、可靠的性能。随着通信技术和人工智能技术的进一步发展，智能巡检机器人将能够在更多领域中发挥更大的作用，为工业自动化和智能化的进程做出更大的贡献。为了应对复杂的巡检环境和恶劣的工作条件，智能巡检机器人通常采用冗余设计，即在关键的传感器部位安装多个不同类型的传感器，保证在某一传感器失效时，仍能依靠其他传感器继续工作，确保巡检任务的正常完成。这种方式可靠，充电效率高，但需要机器人精确对接充电桩。
机器人--手眼标定算法
m0_60274660的博客
09-10 365
相机不在机器人上-----相机坐标系相对于机器人基坐标系的转换矩阵不变；
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

吃点李子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值