Subscriptions: insert

認証されたユーザーのチャンネル登録を追加します。

割り当てへの影響: このメソッドの呼び出しには、50 ユニットの割り当て費用がかかります。

一般的なユースケース

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/youtube/v3/subscriptions

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です（認証と承認の詳細をご確認ください）。

スコープ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part string
part パラメータは、このオペレーションで 2 つの目的を果たします。書き込みオペレーションで設定するプロパティと、API レスポンスに含めるプロパティを識別します。

次のリストに、part パラメータ値に含めることができる名前を示します。
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

リクエストの本文

リクエストの本文に登録チャンネル リソースを指定します。 このリソースの場合:

  • 以下のプロパティの値を指定する必要があります。

    • snippet.resourceId

  • 以下のプロパティの値を設定することができます。

    • snippet.resourceId

レスポンス

成功すると、このメソッドはレスポンスの本文で登録チャンネル リソースを返します。

エラー

次の表に、このメソッドの呼び出しに応じて API が返す可能性があるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
badRequest (400) subscriptionDuplicate 作成しようとしているチャンネル登録は既に存在しています。
badRequest (400) subscriptionForbidden チャンネル登録数の上限に達しました。
badRequest (400) subscriptionForbidden 自分のチャンネルに登録することはできません。
badRequest (400) subscriptionForbidden 最近のチャンネル登録が多すぎます。数時間後に再度お試しください。
forbidden (403) subscriptionForbidden リクエストが適切に認証されていないか、このチャンネルではサポートされていません。
notFound (404) publisherNotFound リクエストの snippet.resourceId プロパティで指定されたリソースが見つかりません。
notFound (404) subscriberNotFound リクエストで特定されているチャンネル登録者が見つかりません。
required (400) publisherRequired リクエストで指定された登録チャンネル リソースは、snippet.resourceId プロパティを使用して、登録するチャンネルを識別する必要があります。

試してみよう:

APIs Explorer を使用してこの API を呼び出し、API リクエストとレスポンスを確認します。