Search: list

Menampilkan kumpulan hasil penelusuran yang cocok dengan parameter kueri yang ditentukan dalam permintaan API. Secara default, kumpulan hasil penelusuran mengidentifikasi resource video, channel, dan playlist yang cocok, tetapi Anda juga dapat mengonfigurasi kueri agar hanya mengambil jenis resource tertentu.

Dampak kuota: Panggilan ke metode ini memiliki biaya kuota sebesar 100 unit.

Kasus penggunaan umum

Permintaan

Permintaan HTTP

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

Parameter

Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.

Parameter
Parameter yang diperlukan
part string
Parameter part menentukan daftar yang dipisahkan koma yang berisi satu atau beberapa properti resource search yang akan disertakan dalam respons API. Setel nilai parameter ke snippet.
Filter (tentukan 0 atau 1 parameter berikut)
forContentOwner boolean
Parameter ini hanya dapat digunakan dalam permintaan resmi yang sesuai, dan ditujukan secara eksklusif untuk partner konten YouTube.

Parameter forContentOwner membatasi penelusuran untuk hanya mengambil video yang dimiliki oleh pemilik konten yang diidentifikasi oleh parameter onBehalfOfContentOwner. Jika forContentOwner disetel ke benar (true), permintaan juga harus memenuhi persyaratan berikut:
  • Parameter onBehalfOfContentOwner wajib diisi.
  • Pengguna yang memberi otorisasi permintaan harus menggunakan akun yang ditautkan ke pemilik konten yang ditentukan.
  • Nilai parameter type harus ditetapkan ke video.
  • Tidak ada parameter lain berikut yang dapat disetel: videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoPaidProductPlacement, videoSyndicated, videoType.
forDeveloper boolean
Parameter ini hanya dapat digunakan dalam permintaan yang diizinkan dengan benar. Parameter forDeveloper membatasi penelusuran untuk hanya mengambil video yang diupload melalui aplikasi atau situs developer. Server API menggunakan kredensial otorisasi permintaan untuk mengidentifikasi developer. Parameter forDeveloper dapat digunakan bersama dengan parameter penelusuran opsional seperti parameter q.

Untuk fitur ini, setiap video yang diupload akan otomatis diberi tag dengan nomor project yang dikaitkan dengan aplikasi developer di Google Developers Console.

Saat permintaan penelusuran selanjutnya menetapkan parameter forDeveloper ke true, server API akan menggunakan kredensial otorisasi permintaan untuk mengidentifikasi developer. Oleh karena itu, developer dapat membatasi hasil pada video yang diupload melalui aplikasi atau situs milik developer sendiri, tetapi tidak dapat membatasi hasil pada video yang diupload melalui aplikasi atau situs lain.
forMine boolean
Parameter ini hanya dapat digunakan dalam permintaan yang diizinkan dengan benar. Parameter forMine membatasi penelusuran untuk hanya mengambil video yang dimiliki oleh pengguna yang diautentikasi. Jika Anda menetapkan parameter ini ke true, nilai parameter type juga harus ditetapkan ke video. Selain itu, tidak satu pun dari parameter lain berikut yang dapat disetel dalam permintaan yang sama: videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoPaidProductPlacement, videoSyndicated, videoType.
Parameter opsional
channelId string
Parameter channelId menunjukkan bahwa respons API hanya boleh berisi resource yang dibuat oleh saluran.

Catatan: Hasil penelusuran dibatasi hingga maksimum 500 video jika permintaan Anda menentukan nilai untuk parameter channelId dan menetapkan nilai parameter type ke video, tetapi permintaan ini juga tidak menetapkan salah satu filter forContentOwner, forDeveloper, atau forMine.
channelType string
Parameter channelType memungkinkan Anda membatasi penelusuran ke jenis saluran tertentu.

Nilai yang dapat diterima adalah:
  • any – Menampilkan semua channel.
  • show – Hanya mengambil acara.
eventType string
Parameter eventType membatasi penelusuran ke peristiwa siaran. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • completed – Hanya sertakan siaran yang telah selesai.
  • live – Hanya sertakan siaran aktif.
  • upcoming – Hanya sertakan siaran mendatang.
location string
Parameter location, bersama dengan parameter locationRadius, menentukan area geografis melingkar dan juga membatasi penelusuran ke video yang menentukan, dalam metadatanya, lokasi geografis yang berada dalam area tersebut. Nilai parameter adalah string yang menentukan koordinat lintang/bujur, misalnya (37.42307,-122.08427).

  • Nilai parameter location mengidentifikasi titik di tengah area.
  • Parameter locationRadius menentukan jarak maksimum lokasi yang dikaitkan dengan video dari titik tersebut agar video tetap disertakan dalam hasil penelusuran.
API akan menampilkan error jika permintaan Anda menentukan nilai untuk parameter location tetapi tidak menentukan nilai untuk parameter locationRadius.

Catatan: Jika Anda menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.
locationRadius string
Parameter locationRadius, bersama dengan parameter location, menentukan area geografis melingkar.

Nilai parameter harus berupa bilangan floating point yang diikuti dengan unit pengukuran. Satuan pengukuran yang valid adalah m, km, ft, dan mi. Misalnya, nilai parameter yang valid mencakup 1500m, 5km, 10000ft, dan 0.75mi. API tidak mendukung nilai parameter locationRadius yang lebih besar dari 1000 kilometer.

Catatan: Lihat definisi parameter location untuk informasi selengkapnya.
maxResults unsigned integer
Parameter maxResults menentukan jumlah maksimum item yang harus ditampilkan dalam kumpulan hasil. Nilai yang dapat diterima adalah 0 hingga 50, inklusif. Nilai defaultnya adalah 5.
onBehalfOfContentOwner string
Parameter ini hanya dapat digunakan dalam permintaan yang diizinkan dengan benar. Catatan: Parameter ini ditujukan khusus untuk partner konten YouTube.

Parameter onBehalfOfContentOwner menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna CMS YouTube yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Parameter ini ditujukan untuk partner konten YouTube yang memiliki dan mengelola banyak channel YouTube yang berbeda. Pemilik konten dapat melakukan autentikasi sekali dan mendapatkan akses ke semua data channel serta video mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel. Akun CMS yang diautentikasi oleh pengguna harus ditautkan ke pemilik konten YouTube yang ditentukan.
order string
Parameter order menentukan metode yang akan digunakan untuk mengurutkan resource dalam respons API. Nilai defaultnya adalah relevance.

Nilai yang dapat diterima:
  • date – Materi diurutkan dalam urutan kronologis terbalik berdasarkan tanggal pembuatannya.
  • rating – Resource diurutkan dari rating tertinggi ke terendah.
  • relevance – Referensi diurutkan berdasarkan relevansinya dengan kueri penelusuran. Ini adalah nilai default untuk parameter ini.
  • title – Materi diurutkan menurut abjad berdasarkan judul.
  • videoCount – Channel diurutkan dalam urutan menurun dari jumlah video yang diupload.
  • viewCount – Resource diurutkan dari jumlah tampilan tertinggi ke terendah. Untuk live streaming, video diurutkan menurut jumlah penonton serentak saat siaran sedang berlangsung.
pageToken string
Parameter pageToken mengidentifikasi halaman tertentu dalam kumpulan hasil yang harus ditampilkan. Dalam respons API, properti nextPageToken dan prevPageToken mengidentifikasi halaman lain yang dapat diambil.
publishedAfter datetime
Parameter publishedAfter menunjukkan bahwa respons API hanya boleh berisi resource yang dibuat pada atau setelah waktu yang ditentukan. Nilainya adalah nilai tanggal-waktu berformat RFC 3339 (1970-01-01T00:00:00Z).
publishedBefore datetime
Parameter publishedBefore menunjukkan bahwa respons API hanya boleh berisi resource yang dibuat sebelum atau pada waktu yang ditentukan. Nilainya adalah nilai tanggal-waktu berformat RFC 3339 (1970-01-01T00:00:00Z).
q string
Parameter q menentukan istilah kueri yang akan ditelusuri.

Permintaan Anda juga dapat menggunakan operator Boolean NOT (-) dan OR (|) untuk mengecualikan video atau menemukan video yang terkait dengan salah satu dari beberapa istilah penelusuran. Misalnya, untuk menelusuri video yang cocok dengan "berperahu" atau "berlayar", tetapkan nilai parameter q ke boating|sailing. Demikian pula, untuk menelusuri video yang cocok dengan "boating" atau "sailing" tetapi tidak "memancing", tetapkan nilai parameter q ke boating|sailing -fishing. Perhatikan bahwa karakter pipa harus di-escape URL saat dikirim dalam permintaan API Anda. Nilai yang di-escape URL untuk karakter pipa adalah %7C.
regionCode string
Parameter regionCode menginstruksikan API untuk menampilkan hasil penelusuran video yang dapat ditonton di negara yang ditentukan. Nilai parameternya adalah kode negara ISO 3166-1 alpha-2.
relevanceLanguage string
Parameter relevanceLanguage menginstruksikan API untuk menampilkan hasil penelusuran yang paling relevan dengan bahasa yang ditentukan. Nilai parameter biasanya adalah kode bahasa dua huruf ISO 639-1. Namun, Anda harus menggunakan nilai zh-Hans untuk China Aksara Sederhana dan zh-Hant untuk China Aksara Tradisional. Perhatikan bahwa hasil dalam bahasa lain tetap akan dikembalikan jika sangat relevan dengan istilah kueri penelusuran.
safeSearch string
Parameter safeSearch menunjukkan apakah hasil penelusuran harus menyertakan konten yang dibatasi serta konten standar.

Nilai yang dapat diterima adalah:
  • moderate – YouTube akan memfilter beberapa konten dari hasil penelusuran dan, setidaknya, akan memfilter konten yang dibatasi di lokalitas Anda. Berdasarkan kontennya, hasil penelusuran dapat dihapus dari hasil penelusuran atau didemosikan di hasil penelusuran. Ini adalah parameter value default.
  • none – YouTube tidak akan memfilter kumpulan hasil penelusuran.
  • strict – YouTube akan mencoba mengecualikan semua konten yang dibatasi dari kumpulan hasil penelusuran. Berdasarkan kontennya, hasil penelusuran dapat dihapus dari hasil penelusuran atau didemosikan di hasil penelusuran.
topicId string
Parameter topicId menunjukkan bahwa respons API hanya boleh berisi resource yang terkait dengan topik yang ditentukan. Nilai ini mengidentifikasi ID topik Freebase.

Penting: Karena Freebase dan Freebase API tidak digunakan lagi, parameter topicId mulai berfungsi secara berbeda sejak 27 Februari 2017. Pada saat itu, YouTube mulai mendukung sejumlah kecil ID topik pilihan, dan Anda hanya dapat menggunakan kumpulan ID yang lebih kecil tersebut sebagai nilai untuk parameter ini.
type string
Parameter type membatasi kueri penelusuran agar hanya mengambil jenis resource tertentu. Nilainya adalah daftar jenis resource yang dipisahkan koma. Nilai defaultnya adalah video,channel,playlist.

Nilai yang dapat diterima:
  • channel
  • playlist
  • video
videoCaption string
Parameter videoCaption menunjukkan apakah API harus memfilter hasil penelusuran video berdasarkan apakah hasil penelusuran video memiliki teks atau tidak. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Tidak memfilter hasil berdasarkan ketersediaan teks.
  • closedCaption – Hanya sertakan video yang memiliki teks.
  • none – Hanya sertakan video yang tidak memiliki teks.
videoCategoryId string
Parameter videoCategoryId memfilter hasil penelusuran video berdasarkan kategorinya. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.
videoDefinition string
Parameter videoDefinition memungkinkan Anda membatasi penelusuran agar hanya menyertakan video definisi tinggi (HD) atau definisi standar (SD). Video HD tersedia untuk diputar dengan resolusi minimal 720p, meskipun resolusi yang lebih tinggi, seperti 1080p, mungkin juga tersedia. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Menampilkan semua video, apa pun resolusinya.
  • high – Hanya mengambil video HD.
  • standard – Hanya mengambil video dalam definisi standar.
videoDimension string
Parameter videoDimension memungkinkan Anda membatasi penelusuran agar hanya mengambil video 2D atau 3D. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • 2d – Membatasi hasil penelusuran untuk mengecualikan video 3D.
  • 3d – Membatasi hasil penelusuran hanya untuk menyertakan video 3D.
  • any – Menyertakan video 3D dan non-3D dalam hasil yang ditampilkan. Nilai ini merupakan default.
videoDuration string
Parameter videoDuration memfilter hasil penelusuran video berdasarkan durasinya. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Tidak memfilter hasil penelusuran video berdasarkan durasinya. Nilai ini merupakan default.
  • long – Hanya sertakan video yang berdurasi lebih dari 20 menit.
  • medium – Hanya sertakan video yang berdurasi antara empat dan 20 menit (inklusif).
  • short – Hanya menyertakan video yang berdurasi kurang dari empat menit.
videoEmbeddable string
Parameter videoEmbeddable memungkinkan Anda membatasi penelusuran hanya untuk video yang dapat disematkan ke halaman web. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Menampilkan semua video, yang dapat disematkan atau tidak.
  • true – Hanya mengambil video yang dapat disematkan.
videoLicense string
Parameter videoLicense memfilter hasil penelusuran agar hanya menyertakan video dengan lisensi tertentu. YouTube memungkinkan uploader video untuk melampirkan lisensi Creative Commons atau lisensi YouTube standar ke setiap videonya. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Menampilkan semua video, apa pun lisensi yang dimilikinya, yang cocok dengan parameter kueri.
  • creativeCommon – Hanya menampilkan video yang memiliki lisensi Creative Commons. Pengguna dapat menggunakan kembali video dengan lisensi ini di video lain yang mereka buat. Pelajari lebih lanjut.
  • youtube – Hanya tampilkan video yang memiliki lisensi YouTube standar.
videoPaidProductPlacement string
Parameter videoPaidProductPlacement memfilter hasil penelusuran agar hanya menyertakan video yang ditandai kreator sebagai memiliki promosi berbayar. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Menampilkan semua video, terlepas dari apakah video tersebut berisi promosi berbayar atau tidak.
  • true – Hanya mengambil video dengan promosi berbayar.
videoSyndicated string
Parameter videoSyndicated memungkinkan Anda membatasi penelusuran hanya untuk video yang dapat diputar di luar youtube.com. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Kembalikan semua video, baik yang disindikasikan atau tidak.
  • true – Hanya mengambil video yang didistribusikan secara offline.
videoType string
Parameter videoType dapat Anda gunakan untuk membatasi penelusuran pada jenis video tertentu. Jika menentukan nilai untuk parameter ini, Anda juga harus menetapkan nilai parameter type ke video.

Nilai yang dapat diterima adalah:
  • any – Menampilkan semua video.
  • episode – Hanya mengambil episode acara.
  • movie – Hanya mengambil film.

Isi permintaan

Jangan berikan isi permintaan saat memanggil metode ini.

Respons

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

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

Properti

Tabel berikut menentukan properti yang muncul di hasil penelusuran:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#searchListResponse.
etag etag
Etag resource ini.
nextPageToken string
Token yang dapat digunakan sebagai nilai parameter pageToken untuk mengambil halaman berikutnya di kumpulan hasil.
prevPageToken string
Token yang dapat digunakan sebagai nilai parameter pageToken untuk mengambil halaman sebelumnya di kumpulan hasil.
regionCode string
Kode wilayah yang digunakan untuk kueri penelusuran. Nilai properti adalah kode negara ISO dua huruf yang mengidentifikasi wilayah. Metode i18nRegions.list akan menampilkan daftar region yang didukung. Nilai defaultnya adalah US. Jika ditentukan wilayah yang tidak didukung, YouTube mungkin masih memilih wilayah lain, bukan nilai default, untuk menangani kueri.
pageInfo object
Objek pageInfo mengenkapsulasi informasi paging untuk kumpulan hasil.
pageInfo.totalResults integer
Jumlah total hasil dalam kumpulan hasil.Perlu diketahui bahwa nilai ini merupakan perkiraan dan mungkin tidak mewakili nilai tepat. Selain itu, nilai maksimumnya adalah 1.000.000.

Anda tidak boleh menggunakan nilai ini untuk membuat link penomoran halaman. Sebagai gantinya, gunakan nilai properti nextPageToken dan prevPageToken untuk menentukan apakah link penomoran halaman akan ditampilkan atau tidak.
pageInfo.resultsPerPage integer
Jumlah hasil yang disertakan dalam respons API.
items[] list
Daftar hasil yang cocok dengan kriteria penelusuran.

Contoh

Catatan: Contoh kode berikut mungkin tidak mewakili semua bahasa pemrograman yang didukung. Baca dokumentasi library klien untuk mengetahui daftar bahasa yang didukung.

Apps Script

Fungsi ini mencari video yang terkait dengan kata kunci 'dogs'. Judul dan ID video dari hasil penelusuran dicatat ke log Apps Script.

Perhatikan bahwa contoh ini membatasi hasil hingga 25. Untuk menampilkan hasil lainnya, teruskan parameter tambahan seperti yang didokumentasikan di sini: https://developers.google.com/youtube/v3/docs/search/list 
function searchByKeyword() {
  var results = YouTube.Search.list('id,snippet', {q: 'dogs', maxResults: 25});

  for(var i in results.items) {
    var item = results.items[i];
    Logger.log('[%s] Title: %s', item.id.videoId, item.snippet.title);
  }
}
youtube.gs

Go

Contoh kode ini memanggil metode search.list API untuk mengambil hasil penelusuran yang terkait dengan kata kunci tertentu.

Contoh ini menggunakan library klien Go.

package main

import (
	"flag"
	"fmt"
	"log"
	"net/http"

	"google.golang.org/api/googleapi/transport"
	"google.golang.org/api/youtube/v3"
)

var (
	query      = flag.String("query", "Google", "Search term")
	maxResults = flag.Int64("max-results", 25, "Max YouTube results")
)

const developerKey = "YOUR DEVELOPER KEY"

func main() {
	flag.Parse()

	client := &http.Client{
		Transport: &transport.APIKey{Key: developerKey},
	}

	service, err := youtube.New(client)
	if err != nil {
		log.Fatalf("Error creating new YouTube client: %v", err)
	}

	// Make the API call to YouTube.
	call := service.Search.List("id,snippet").
		Q(*query).
		MaxResults(*maxResults)
	response, err := call.Do()
	handleError(err, "")

	// Group video, channel, and playlist results in separate lists.
	videos := make(map[string]string)
	channels := make(map[string]string)
	playlists := make(map[string]string)

	// Iterate through each item and add it to the correct list.
	for _, item := range response.Items {
		switch item.Id.Kind {
		case "youtube#video":
			videos[item.Id.VideoId] = item.Snippet.Title
		case "youtube#channel":
			channels[item.Id.ChannelId] = item.Snippet.Title
		case "youtube#playlist":
			playlists[item.Id.PlaylistId] = item.Snippet.Title
		}
	}

	printIDs("Videos", videos)
	printIDs("Channels", channels)
	printIDs("Playlists", playlists)
}

// Print the ID and title of each result in a list as well as a name that
// identifies the list. For example, print the word section name "Videos"
// above a list of video search results, followed by the video ID and title
// of each matching video.
func printIDs(sectionName string, matches map[string]string) {
	fmt.Printf("%v:\n", sectionName)
	for id, title := range matches {
		fmt.Printf("[%v] %v\n", id, title)
	}
	fmt.Printf("\n\n")
}

search_by_keyword.go

.NET

Contoh kode berikut memanggil metode search.list API untuk mengambil hasil penelusuran yang terkait dengan kata kunci tertentu.

Contoh ini menggunakan library klien.NET.

using System;
using System.Collections.Generic;
using System.IO;
using System.Reflection;
using System.Threading;
using System.Threading.Tasks;

using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using Google.Apis.Upload;
using Google.Apis.Util.Store;
using Google.Apis.YouTube.v3;
using Google.Apis.YouTube.v3.Data;

namespace Google.Apis.YouTube.Samples
{
  /// <summary>
  /// YouTube Data API v3 sample: search by keyword.
  /// Relies on the Google APIs Client Library for .NET, v1.7.0 or higher.
  /// See https://developers.google.com/api-client-library/dotnet/get_started
  ///
  /// Set ApiKey to the API key value from the APIs & auth > Registered apps tab of
  ///   https://cloud.google.com/console
  /// Please ensure that you have enabled the YouTube Data API for your project.
  /// </summary>
  internal class Search
  {
    [STAThread]
    static void Main(string[] args)
    {
      Console.WriteLine("YouTube Data API: Search");
      Console.WriteLine("========================");

      try
      {
        new Search().Run().Wait();
      }
      catch (AggregateException ex)
      {
        foreach (var e in ex.InnerExceptions)
        {
          Console.WriteLine("Error: " + e.Message);
        }
      }

      Console.WriteLine("Press any key to continue...");
      Console.ReadKey();
    }

    private async Task Run()
    {
      var youtubeService = new YouTubeService(new BaseClientService.Initializer()
      {
        ApiKey = "REPLACE_ME",
        ApplicationName = this.GetType().ToString()
      });

      var searchListRequest = youtubeService.Search.List("snippet");
      searchListRequest.Q = "Google"; // Replace with your search term.
      searchListRequest.MaxResults = 50;

      // Call the search.list method to retrieve results matching the specified query term.
      var searchListResponse = await searchListRequest.ExecuteAsync();

      List<string> videos = new List<string>();
      List<string> channels = new List<string>();
      List<string> playlists = new List<string>();

      // Add each result to the appropriate list, and then display the lists of
      // matching videos, channels, and playlists.
      foreach (var searchResult in searchListResponse.Items)
      {
        switch (searchResult.Id.Kind)
        {
          case "youtube#video":
            videos.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.VideoId));
            break;

          case "youtube#channel":
            channels.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.ChannelId));
            break;

          case "youtube#playlist":
            playlists.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.PlaylistId));
            break;
        }
      }

      Console.WriteLine(String.Format("Videos:\n{0}\n", string.Join("\n", videos)));
      Console.WriteLine(String.Format("Channels:\n{0}\n", string.Join("\n", channels)));
      Console.WriteLine(String.Format("Playlists:\n{0}\n", string.Join("\n", playlists)));
    }
  }
}

Search.cs

Ruby

Contoh ini memanggil metode search.list API untuk mengambil hasil penelusuran yang terkait dengan kata kunci tertentu.

Contoh ini menggunakan library klien Ruby.

#!/usr/bin/ruby

require 'rubygems'
gem 'google-api-client', '>0.7'
require 'google/api_client'
require 'trollop'

# Set DEVELOPER_KEY to the API key value from the APIs & auth > Credentials
# tab of
# {{ Google Cloud Console }} <{{ https://cloud.google.com/console }}>
# Please ensure that you have enabled the YouTube Data API for your project.
DEVELOPER_KEY = 'REPLACE_ME'
YOUTUBE_API_SERVICE_NAME = 'youtube'
YOUTUBE_API_VERSION = 'v3'

def get_service
  client = Google::APIClient.new(
    :key => DEVELOPER_KEY,
    :authorization => nil,
    :application_name => $PROGRAM_NAME,
    :application_version => '1.0.0'
  )
  youtube = client.discovered_api(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION)

  return client, youtube
end

def main
  opts = Trollop::options do
    opt :q, 'Search term', :type => String, :default => 'Google'
    opt :max_results, 'Max results', :type => :int, :default => 25
  end

  client, youtube = get_service

  begin
    # Call the search.list method to retrieve results matching the specified
    # query term.
    search_response = client.execute!(
      :api_method => youtube.search.list,
      :parameters => {
        :part => 'snippet',
        :q => opts[:q],
        :maxResults => opts[:max_results]
      }
    )

    videos = []
    channels = []
    playlists = []

    # Add each result to the appropriate list, and then display the lists of
    # matching videos, channels, and playlists.
    search_response.data.items.each do |search_result|
      case search_result.id.kind
        when 'youtube#video'
          videos << "#{search_result.snippet.title} (#{search_result.id.videoId})"
        when 'youtube#channel'
          channels << "#{search_result.snippet.title} (#{search_result.id.channelId})"
        when 'youtube#playlist'
          playlists << "#{search_result.snippet.title} (#{search_result.id.playlistId})"
      end
    end

    puts "Videos:\n", videos, "\n"
    puts "Channels:\n", channels, "\n"
    puts "Playlists:\n", playlists, "\n"
  rescue Google::APIClient::TransmissionError => e
    puts e.result.body
  end
end

main

search.rb

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk detail selengkapnya.

Jenis error Detail error Deskripsi
badRequest (400) invalidChannelId Parameter channelId menetapkan ID channel yang tidak valid.
badRequest (400) invalidLocation Format nilai parameter location dan/atau locationRadius salah.
badRequest (400) invalidRelevanceLanguage Format nilai parameter relevanceLanguage salah.
badRequest (400) invalidSearchFilter Permintaan berisi kombinasi filter dan/atau pembatasan penelusuran yang tidak valid. Perhatikan bahwa Anda harus menetapkan parameter type ke video jika Anda menetapkan parameter forContentOwner atau forMine ke true. Anda juga harus menetapkan parameter type ke video jika menetapkan nilai untuk parameter eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated, atau videoType.

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.