LiveStreams: list

傳回符合 API 要求參數的影片串流清單。

常見用途

要求

HTTP 要求

GET https://www.googleapis.com/youtube/v3/liveStreams

授權

此要求需要至少具備下列其中一個範圍的授權 (進一步瞭解驗證和授權)。

範圍
https://www.googleapis.com/auth/youtube.readonly
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

參數

下表列出這項查詢支援的參數。上方列出的所有參數都是查詢參數。

參數
必要參數
part string
part 參數會指定以逗號分隔的清單,其中包含 API 回應將包含的一或多個 liveStream 資源屬性。您可以在參數值中加入的 part 名稱為 idsnippetcdnstatus
篩選器 (請僅指定下列其中一個參數)
id string
id 參數可指定以逗號分隔的 YouTube 串流 ID 清單,以識別要擷取的串流。在 liveStream 資源中,id 屬性會指定串流的 ID。
mine boolean
這個參數只能在妥善的授權要求中使用。mine 參數可用來指示 API 只傳回已驗證使用者擁有的串流。只要將參數值設為 true,即可只擷取自己的串流。
選用參數
maxResults unsigned integer
maxResults 參數會指定要在結果集中傳回的項目數量上限。可接受的值為 050 (含首尾)。預設值為 5
onBehalfOfContentOwner string
這個參數只能在妥善的授權要求中使用。注意:這個參數僅適用於 YouTube 內容合作夥伴。

onBehalfOfContentOwner 參數表示請求的授權憑證能代表代替參數值中所指定的內容擁有者所擔任的 YouTube CMS 使用者。這個參數適用於擁有和管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。內容擁有者只要驗證一次即可,就能存取所有影片和頻道資料,而不需要為每個頻道分別提供驗證憑證。使用者驗證的 CMS 帳戶必須連結至指定的 YouTube 內容擁有者。
onBehalfOfContentOwnerChannel string
這個參數只能在妥善的授權要求中使用。這個參數只能在適當的授權要求中使用。注意:這個參數僅適用於 YouTube 內容合作夥伴。

onBehalfOfContentOwnerChannel 參數會指定影片所屬頻道的 YouTube 頻道 ID。如果要求指定了 onBehalfOfContentOwner 參數的值,就必須使用這個參數,而且這個參數只能搭配該參數使用。此外,要求必須使用連結至 onBehalfOfContentOwner 參數指定內容擁有者的 CMS 帳戶。最後,onBehalfOfContentOwnerChannel 參數值指定的管道必須連結至 onBehalfOfContentOwner 參數指定的內容擁有者。

這個參數適用於擁有和管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。這樣內容擁有者就能驗證一次,並且能代表參數值指定的頻道執行動作,而不必分別為每個頻道提供驗證憑證。
pageToken string
pageToken 參數可指定要傳回結果集中的網頁。在 API 回應中,nextPageTokenprevPageToken 屬性可識別其他可擷取的網頁。

要求主體

呼叫此方法時請不要提供要求主體。

回應

如果成功的話,這個方法會傳回回應內文,其結構如下:

{
  "kind": "youtube#liveStreamListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveStream Resource
  ]
}

屬性

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

屬性
kind string
識別 API 資源類型。這個值會是 youtube#liveStreamListResponse
etag etag
這項資源的 Etag。
nextPageToken string
這個符記可用做 pageToken 參數的值,以擷取結果集的下一頁。
prevPageToken string
這個符記可用做 pageToken 參數的值,以擷取結果集的上一頁。
pageInfo object
pageInfo 物件會封裝結果集的分頁資訊。
pageInfo.totalResults integer
結果集中的結果總數。
pageInfo.resultsPerPage integer
API 回應中包含的結果數量。
items[] list
符合要求條件的直播清單。

錯誤

下表說明 API 在回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。

錯誤類型 錯誤詳細資料 說明
insufficientPermissions insufficientLivePermissions 要求未獲授權,無法擷取指定的直播活動。
insufficientPermissions liveStreamingNotEnabled 授權要求的使用者未啟用 YouTube 的即時串流影片。使用者可以前往 https://www.youtube.com/features 瞭解詳情。

試試看!

使用 APIs Explorer 呼叫這個 API 並查看 API 要求和回應。