導入:搜尋要求

以下範例說明如何在 v3 API 中完成多種不同類型的搜尋要求。

影片

此範例呼叫 search.list 方法,以找出與查詢「滑板狗」相關的最多高畫質 (HD) 影片。查詢會設定 orderpartqtypevideoDefinition 參數。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &order=viewCount
        &q=skateboarding+dog
        &type=video
        &videoDefinition=high

如需程式碼範例,請參閱 search.list 方法的說明文件。

播放清單

這個範例說明如何尋找與查詢字詞「GoogleDevelopers」相符的播放清單。其會呼叫 search.list 方法,並將 type 參數值設為 playlist,這樣結果集就只會包含播放清單。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=GoogleDevelopers
        &type=playlist

頻道

本例說明如何尋找與查詢字詞「travel」相符的頻道。其會呼叫 search.list 方法,並將 type 參數值設為 channel,這樣結果集就只會包含管道。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

特定語言的相關搜尋結果

這個範例會呼叫 search.list 方法,尋找與特定語言最相關的搜尋結果。此範例顯示的查詢字詞是「海洋」 (q=marine),而 API 回應應包含與法文 (relevanceLanguage=fr) 最相關的結果。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=marine
        &relevanceLanguage=fr

請注意,此要求不會設定 type 參數的值,這代表每個搜尋結果皆可參照影片、播放清單或頻道。

透過開發人員應用程式或網站上傳的影片

本例說明如何使用 forDeveloper 參數限制搜尋,只擷取透過開發人員應用程式或網站上傳的影片。這個參數可搭配選用的搜尋參數使用,例如 q 參數。

注意:APIs Explorer 不支援上傳影片,因此這個查詢實際上並不會在 APIs Explorer 中傳回結果。您可以在 APIs Explorer 之外,針對自己的應用程式執行這項查詢,但無法透過 APIs Explorer 取得您的應用程式結果。

系統會在 Google API 控制台中,為上傳的各部影片加上與開發人員應用程式相關聯的專案編號。

當搜尋要求隨後將 forDeveloper 參數設為 true 時,API 服務會使用要求的授權憑證來識別開發人員。因此,開發人員可限定搜尋範圍僅限透過開發人員應用程式或網站所上傳的影片,但不能只透過其他應用程式或網站上傳。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true