注意事項:這項資源已於 2020 年 3 月 31 日淘汰。已由
在本次淘汰後,我們將於 2020 年 9 月 30 日當天或之後停止支援
member
資源取代。您可以在 YouTube Data API 說明文件中找到該資源的相關資訊。在本次淘汰後,我們將於 2020 年 9 月 30 日當天或之後停止支援
sponsors.list
方法。API 用戶端應更新對 sponsors.list
方法的呼叫,以便改用 members.list
方法。sponsor
資源代表 YouTube 頻道的頻道會員 (舊稱「贊助方」)。
會員可以定期為創作者提供金錢支援,並獲得特殊福利。舉例來說,當創作者為聊天室開啟會員專屬模式時,成員就可以進行即時通訊。
方法
這個 API 支援下列 sponsors
資源的方法:
資源表示法
以下 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 ) 格式指定。 |