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