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