Activities: insert

YouTube はチャンネルの掲示板機能を非推奨としたため、このメソッドはサポートされなくなりました。

詳しくは、YouTube ヘルプセンターをご覧ください。

特定のチャンネルに対するお知らせメッセージを投稿します（リクエストを送信するユーザーは、チャンネルに代わって行動する権限を持っている必要があります）。

注: 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 名が含まれています。
  • 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 お知らせメッセージの投稿と動画を関連付けようとしていますが、その動画が見つかりません。contentDetails.bulletinPosted.playlistId プロパティの値を確認します。
notFound (404) videoNotFound お知らせメッセージの投稿と動画を関連付けようとしていますが、その動画が見つかりません。contentDetails.bulletinPosted.videoId プロパティの値を確認します。
userRateLimitExceeded (403) rateLimitExceeded リクエストを完了できません。既に割り当てを超えています。