Module comment.py

  1. from bilibili_api import comment

评论相关。

关于资源 ID（oid）的一些示例（{}部分为应该传入的参数）。

  • 视频：AV 号：av{170001}。
  • 专栏：cv{9762979}。
  • 动态（画册类型）：{116859542}。
  • 动态（纯文本）：{497080393649439253}。

class ResourceType

Extends: enum.Enum

资源类型枚举。

  • VIDEO: 视频。
  • ARTICLE: 专栏。
  • DYNAMIC_DRAW: 画册。
  • DYNAMIC: 动态（画册也属于动态的一种，只不过画册还有一个专门的 ID）。
  • AUDIO：音频。
  • AUDIO_LIST：歌单。

class OrderType

Extends: enum.Enum

评论排序方式枚举。

  • LIKE：按点赞数倒序。
  • TIME：按发布时间倒序。

class Comment

对单条评论的相关操作

Attributes

name type description
oid int 评论所在资源 ID。
type_ ResourceType 评论所在资源类型枚举。
rpid int 评论 ID。
credential Credential 凭据

Functions

def __init__()

name type description
oid int 评论所在资源 ID。
type_ ResourceType 评论所在资源类型枚举。
rpid int 评论 ID。
credential Credential 凭据

async def like()

name type description
status bool, optional 状态, Defaults to True.

点赞评论。

Returns: API 调用返回结果。

async def hate()

name type description
status bool, optional 状态, Defaults to True.

点踩评论。

Returns: API 调用返回结果。

async def pin()

name type description
status bool, optional 状态, Defaults to True.

置顶评论。

Returns: API 调用返回结果。

async def delete()

删除评论

Returns: API 调用返回结果。

async def get_sub_comments()

name type description
page_index int, optional 页码索引，从 1 开始。Defaults to 1.

获取子评论。即评论下的评论。

Returns: API 调用返回结果。

async def send_comment()

name type description
text str 评论内容
oid int 资源 ID
type_ ResourceType 资源类型枚举
root int, optional 根评论 ID, Defaults to None.
parent int, optional 父评论 ID, Defaults to None.
credential Credential 凭据

通用发送评论 API。

说明 root 和 parent，假设评论的是视频，常见的评论有三种情况：

  1. 只在视频下面发送评论：root=None, parent=None；
  2. 回复视频下面的评论：root=评论 ID, parent=None；
  3. 回复视频下面的评论中的评论：root=在哪条评论下评论的 ID, parent=回复哪条评论的 ID。

当 root 为空时，parent 必须为空。

Returns: API 调用返回结果。

async def get_comments()

name type description
oid int 资源 ID
type_ ResourceType 资源类型枚举
page_index int, optional 页码. Defaults to 1.
order OrderType, optional 排序方式枚举. Defaults to OrderType.TIME.
credential Credential, optional 凭据. Defaults to None.

获取资源评论列表。

Returns: API 调用返回结果。