Sponsors

注意事項:這項資源已於 2020 年 3 月 31 日淘汰。已由 member 資源取代。您可以在 YouTube Data API 說明文件中找到該資源的相關資訊。

在本次淘汰後,我們將於 2020 年 9 月 30 日當天或之後停止支援 sponsors.list 方法。API 用戶端應更新對 sponsors.list 方法的呼叫,以便改用 members.list 方法。

sponsor 資源代表 YouTube 頻道的頻道會員 (舊稱「贊助方」)。 會員可以定期為創作者提供金錢支援,並獲得特殊福利。舉例來說,當創作者為聊天室開啟會員專屬模式時,成員就可以進行即時通訊。

方法

這個 API 支援下列 sponsors 資源的方法:

list
列出頻道的贊助商。API 要求必須獲得頻道擁有者的授權。立即試用

資源表示法

以下 JSON 結構顯示了 sponsors 資源的格式:

{
 
"kind": "youtube#sponsor",
 
"etag": etag,
 
"id": string,
 
"snippet": {
   
"channelId": string,
   
"sponsorDetails": {
     
"channelId": string,
     
"channelUrl": string,
     
"displayName": string,
     
"profileImageUrl": string
   
},
   
"sponsorSince": datetime
 
}
}

屬性

下表定義此資源中顯示的屬性:

屬性
kind string
識別 API 資源類型。這個值會是 youtube#sponsor
etag etag
這項資源的 Etag。
id string
YouTube 指派的唯一識別碼,可用來識別贊助商。
snippet object
snippet 物件包含關於贊助者的詳細資料。
snippet.channelId string
此 ID 表示贊助頻道。
snippet.sponsorDetails object
這個物件包含關於贊助者的詳細資料。
snippet.sponsorDetails.channelId string
YouTube 頻道 ID。
snippet.sponsorDetails.channelUrl string
頻道的網址。
snippet.sponsorDetails.displayName string
頻道的顯示名稱。
snippet.sponsorDetails.profileImageUrl string
頻道的顯示圖片網址。
snippet.sponsorSince datetime
使用者成為贊助商的日期和時間。這個值以 ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) 格式指定。