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 リクエストを完了できません。既に割り当てを超えています。