認証されたユーザーのチャンネル登録を追加します。
割り当ての影響: このメソッドを呼び出すと、割り当てコストは 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 名を示します。
|
|
リクエスト本文
リクエストの本文にサブスクリプション リソースを指定します。対象リソース:
-
以下のプロパティの値を指定する必要があります。
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 のリクエストとレスポンスを確認します。