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) 格式指定。