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 のリクエストとレスポンスを確認します。