實作:搜尋要求

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

影片

這個範例會呼叫 search.list 方法,找出與查詢「skateboarding dog」相關的最多人觀看的高畫質 (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 方法,找出與特定語言最相關的搜尋結果。這個範例顯示查詢字詞為「marine」 (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