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 由于您已超出您的配额，因此请求无法完成。