Subscriptions: insert

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

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

常見用途

要求

HTTP 要求

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

要求主體

在要求主體中提供訂閱資源。針對該資源：

  • 您必須指定下列屬性的值：

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