Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

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 要求和回應。