Activities: insert

YouTube 已弃用频道公告功能,因此不再支持此方法。

如需了解详情,请参阅 YouTube 帮助中心

为特定频道发布公告。(提交要求的用户必须获得授权,才能代表频道执行操作。)

注意:即使 activity 资源可能包含关于用户给视频评分或将视频标记为收藏等操作的信息,您也需要使用其他 API 方法生成这些 activity 资源。例如,您可以使用 API 的 videos.rate() 方法对视频进行评分,并使用 playlistItems.insert() 方法将视频加入收藏。

配额影响:调用此方法的配额费用为 50 个单位。

请求

HTTP 请求

POST https://www.googleapis.com/youtube/v3/activities

授权

此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

参数

下表列出了此查询支持的参数。列出的所有参数都是查询参数。

参数
必需参数
part string
part 参数在此操作中有两个目的。它标识了写入操作将设置的属性以及 API 响应将包含的属性。

以下列表包含您可以在参数值中包含的 part 名称:
  • contentDetails
  • id
  • snippet

请求正文

在请求正文中提供 activity 资源。对于相应资源:

  • 您必须为以下属性指定值:

    • snippet.description
  • 您可以为以下属性设置值:

    • snippet.description
    • contentDetails.bulletin.resourceId

响应

如果成功,此方法将在响应正文中返回 activity 资源

错误

下表列出了该 API 为响应对此方法的调用可能返回的错误消息。如需了解详情,请参阅错误消息文档。

错误类型 错误详情 说明
badRequest (400) bulletinTextRequired 该请求必须使用 snippet 对象的 description 属性提供公告帖子的文本。
badRequest (400) invalidMetadata kind 属性与所提供的 ID 类型不匹配。
forbidden (403) forbidden 请求未获得适当授权。
notFound (404) playlistNotFound YouTube 找不到您尝试与公告帖子关联的视频。检查 contentDetails.bulletinPosted.playlistId 属性的值。
notFound (404) videoNotFound YouTube 找不到您尝试与公告帖子关联的视频。检查 contentDetails.bulletinPosted.videoId 属性的值。
userRateLimitExceeded (403) rateLimitExceeded 由于已超出您的配额,此请求无法完成。