このページは Cloud Translation API によって翻訳されました。

Subscriptions: insert

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

割り当てへの影響: このメソッドの呼び出しにより、50 ユニットの割り当てコストが発生します。

一般的なユースケース

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`

リクエストの本文には定期購入リソースを指定します。このリソースについて:

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

次の表に、このメソッドの呼び出しに対して 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 のリクエストとレスポンスを確認します。