注意:只有個別創作者可以使用這個端點,針對已啟用頻道會員功能的頻道建立 YouTube 頻道。請與您的 Google 或 YouTube 代表聯絡,要求存取權。
列出授權要求的頻道會員層級。層級會以隱含顯示順序傳回。向此方法發出的 API 要求會產生下列其中一種回應:
- 如果創作者啟用了頻道會員功能及提供價格層級,API 回應就會列出層級清單。
- 如果創作者已啟用頻道會員功能,但尚未定義定價等級,則 API 回應包含空白清單。
- 如果創作者尚未啟用頻道會員功能,API 會傳回
channelMembershipsNotEnabled
錯誤。
配額影響:呼叫此方法的配額費用為 1 單位。
要求
HTTP 要求
GET https://www.googleapis.com/youtube/v3/membershipsLevels
此要求需要以下範圍的授權:
範圍 |
---|
https://www.googleapis.com/auth/youtube.channel-memberships.creator |
參數
下表列出這項查詢支援的參數。上方列出的所有參數都是查詢參數。
參數 | ||
---|---|---|
必要參數 | ||
part |
string part 參數會指定 API 回應將包含的 membershipsLevel 資源屬性。參數值是以逗號分隔的資源清單清單。下列是可擷取的部分:
|
要求主體
呼叫此方法時請不要提供要求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{ "kind": "youtube#membershipsLevelListResponse", "etag": etag, "items": [ membershipsLevel Resource ] }
屬性
下表定義此資源中顯示的屬性:
屬性 | |
---|---|
kind |
string 識別 API 資源類型。這個值會是 youtube#membershipsLevelListResponse 。 |
etag |
etag 這項資源的 Etag。 |
items[] |
list 授權 API 要求的管道所擁有的 membershipsLevel 資源清單。 |
錯誤
下表說明 API 在回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。
錯誤類型 | 錯誤詳細資料 | 說明 |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
授權要求的創作者頻道未啟用頻道會員功能。 |