为特定频道发布公告。(提交要求的用户必须获得授权,才能代表频道执行操作。)
注意:即使 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 名称:
|
请求正文
在请求正文中提供 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 |
由于已超出您的配额,此请求无法完成。 |