Subscriptions: insert

在已驗證使用者的頻道中新增訂閱。

配額影響：呼叫這個方法的配額費用為 50 個單位。

常見用途

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

這項要求需要至少下列其中一個範圍的授權 (進一步瞭解驗證和授權)。

內容範圍
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。

參數
必要參數
`part`	`string` 在這項作業中，`part` 參數有兩個用途。它會指出寫入作業設定的屬性，以及 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 要求和回應。