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

请求正文

在请求正文中提供活动资源。 对于该资源：

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

    • snippet.description

  • 您可以为以下属性设置值：

    • snippet.description
    • contentDetails.bulletin.resourceId

响应

如果成功，此方法将在响应正文中返回一项活动资源。

错误

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