特定のチャンネルに対するお知らせメッセージを投稿します(リクエストを送信するユーザーは、チャンネルの代理として動作する権限を持っている必要があります)。
注: activity
リソースには、ユーザーが動画を評価する、動画をお気に入りとしてマークするなどのアクションに関する情報を含めることができますが、これらの activity
リソースを生成するには他の API メソッドを使用する必要があります。たとえば、API の videos.rate()
メソッドを使用して動画を評価し、playlistItems.insert()
メソッドを使用して動画をお気に入りに設定します。
割り当ての影響:このメソッドを呼び出すと、割り当てコストは 50 単位になります。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/youtube/v3/activities
承認
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
範囲 |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
パラメータ
次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
パラメータ | ||
---|---|---|
必須パラメータ | ||
part |
string このオペレーションでは、 part パラメータに 2 つの目的があります。書き込みオペレーションで設定するプロパティと、API レスポンスに含まれるプロパティを指定します。次のリストに、パラメータ値に含めることができる part 名を示します。
|
リクエスト本文
リクエストの本文にアクティビティ リソースを指定します。対象リソース:
-
以下のプロパティの値を指定する必要があります。
snippet.description
-
以下のプロパティの値を設定することができます。
snippet.description
contentDetails.bulletin.resourceId
レスポンス
成功すると、このメソッドはレスポンスの本文でアクティビティ リソースを返します。
エラー
次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。
エラーのタイプ | エラーの詳細 | 説明 |
---|---|---|
badRequest (400) |
bulletinTextRequired |
通知の投稿のテキストを提供するには、snippet オブジェクトの description プロパティを使用する必要があります。 |
badRequest (400) |
invalidMetadata |
kind プロパティが、指定された ID のタイプと一致しません。 |
forbidden (403) |
forbidden |
リクエストが正しく承認されていません。 |
notFound (404) |
playlistNotFound |
お知らせメッセージの投稿と動画を関連付けようとしていますが、その動画が見つかりません。contentDetails.bulletinPosted.playlistId プロパティの値を確認します。 |
notFound (404) |
videoNotFound |
お知らせメッセージの投稿と動画を関連付けようとしていますが、その動画が見つかりません。contentDetails.bulletinPosted.videoId プロパティの値を確認します。 |
userRateLimitExceeded (403) |
rateLimitExceeded |
リクエストを完了できません。既に割り当てを超えています。 |