Talimatlar
Etkileşimli kod snippet'i aracı, API isteklerini kolayca test etmenize ve bu isteklere özel kod örnekleri oluşturmanıza olanak tanır. Belirli bir yöntem için araç, bir veya daha fazla kullanım alanı için kod snippet'leri gösterir ve her kullanım alanı, söz konusu yöntemi çağırmanın yaygın bir yöntemini açıklar. Örneğin, belirli bir kanal veya geçerli kullanıcının kanalı hakkındaki verileri almak için channels.list
yöntemini çağırabilirsiniz.
API istekleri yürütme
İstek parametreleri listesinin yanındaki Yürüt düğmesini tıklayarak istekleri yürütebilirsiniz. Daha önce uygulamayı sizin adınıza API istekleri göndermesi için yetkilendirmediyseniz, bunu yapmanız istenir. Ek bir önlem olarak isteğiniz, kanalınızla ilişkilendirilmiş kaynakları ekleme, güncelleme veya silme gibi bir yazma işlemi gerçekleştirirse fiilen yürütülmeden önce isteği yürütmek istediğinizi onaylamanız istenir.
Kod snippet'lerini ve tam örnekleri aç/kapat
Her bir kullanım durumu için araç, çağrılan yönteme özgü kodu tanımlayan bir kod snippet'i gösterir. Her snippet, çağrılan yöntemin yanı sıra API isteğinde kullanılan parametre ve özellik değerlerini de tanımlar.
Ayrıca araç, API isteklerini yetkilendirmek ve API istekleri oluşturmak için bu kod snippet'ini, ortak metin işlevlerini tanımlayan bir şablona yerleştiren tam bir kod örneği de gösterir. Snippet ve tam örnek arasında geçiş yapmak için örneklerin üzerindeki kaydırma çubuğunu kullanabilirsiniz:
Tam kod örneklerini yerel olarak çalıştırma
Tam kod örnekleri kopyalanıp yerel olarak çalıştırılmak üzere tasarlanmıştır. Tam kod örneklerini çalıştırmak için aşağıdaki ön koşulları ve kurulum adımlarını lütfen unutmayın:
Ön koşullar
- Java 1.7 veya üstü
- Gradle 2.3 veya üzeri
Projenizi oluşturma ve kod örnekleri çalıştırma
-
API Konsolu'nda proje oluşturun ve bir web uygulaması için kimlik bilgilerini ayarlayın. Yetkili yönlendirme URI'lerini uygun şekilde ayarlayın.
-
Projenizi hazırlamak için API Java Hızlı Başlangıç Kılavuzu'ndaki talimatları izleyin ancak varsayılan
build.gradle
dosyasının içeriğini aşağıdaki kodla değiştirin:apply plugin: 'java' apply plugin: 'application' mainClassName = 'ApiExample' sourceCompatibility = 1.7 targetCompatibility = 1.7 version = '1.0' repositories { mavenCentral() } dependencies { compile 'com.google.api-client:google-api-client:1.22.0' compile 'com.google.oauth-client:google-oauth-client-jetty:1.22.0' compile 'com.google.apis:google-api-services-youtube:v3-rev182-1.22.0' compile group: 'com.google.code.gson', name: 'gson', version: '1.7.2' compile group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: '2.4.4' } compileJava { options.compilerArgs << "-Xlint:unchecked" << "-Xlint:deprecation" }
-
Çalışma dizininizde, kimlik bilgilerinizle ilişkili
client_secrets.json
dosyasınısrc/main/resources/client_secret.json
hedefine kaydedin. -
Çalışma dizininizden, kod örneğinin tamamını
src/main/java/ApiExample.java
klasörüne kopyalayın. (Her örnekte sınıf adıApiExample
olduğundan farklı örnekler çalıştırmak içinbuild.gradle
dosyasını değiştirmeniz gerekmez.) -
Örneği komut satırından çalıştırın:
gradle -q run
-
Çoğu örnekte bir şey
STDOUT
yazıcısına yazdırılır. Oynatma listesi veya kanal bölümü oluşturma istekleri gibi veri yazan isteklerin etkilerini görmek için YouTube web sitesine de göz atabilirsiniz.
-
API Konsolu'nda proje oluşturun ve bir web uygulaması için kimlik bilgilerini ayarlayın. İstek göndereceğiniz URL'yi tanımlamak için yetkili JavaScript kaynaklarını ayarlayın (ör.
http://localhost
). -
Tam kod örneğini, web sunucunuz tarafından erişilebilen bir yerel dosyaya (ör.
/var/www/html/example.html
) kopyalayın. -
Kod örneğinde, istek için kullanılacak istemci kimliğini belirleyen satırı bulun ve değeri kimlik bilgilerinizin istemci kimliğiyle değiştirin:
gapi.client.init({ 'clientId': 'REPLACE_ME',
-
Dosyayı tarayıcınızda açın (ör.
http://localhost/example.html
). Google Chrome gibi hata ayıklama konsoluna sahip bir tarayıcı kullanmanız önerilir. -
Gerekirse isteği yetkilendirin. İstek yetkilendirilmişse hata ayıklama konsolu, isteğe verilen API yanıtını bir JSON nesnesi olarak göstermelidir.
Ön koşullar
- Node.js yüklenmelidir.
- npm paket yönetim aracı (Node.js ile birlikte gelir).
- Node.js için Google API'leri İstemci Kitaplığı:
npm install googleapis --save
- İnternete ve web tarayıcısına erişim.
- Google Hesabı.
Projenizi oluşturma ve kod örnekleri çalıştırma
-
API Konsolu'nda bir proje oluşturun ve Google API Konsolu'nda OAuth 2.0 kimlik bilgilerini ayarlayın. Kimlik bilgilerinizi ayarlarken uygulama türünü Other olarak ayarlayın.
-
Kimlik bilgilerinizle ilişkilendirilen
client_secret.json
dosyasını yerel bir dosyaya kaydedin. -
Kod örneğinin tamamını
client_secret.json
dosyasıyla aynı dizinde bulunan yerel bir dosyaya kopyalayın (veya bu dosyanın konumunu doğru şekilde tanımlamak için örneği değiştirin.) -
Örneği komut satırından çalıştırın:
node sample.js
-
Çoğu örnekte bir şeyler
STDOUT
konumuna veya web uygulaması örnekleri için görüntülediğiniz web sayfasına yazdırılır. Oynatma listesi veya kanal bölümü oluşturma istekleri gibi veri yazan isteklerin etkilerini görmek için YouTube web sitesine de göz atabilirsiniz.
Ön koşullar
- Python 2.6 veya sonraki sürümler
- Pip paket yönetim aracı
- Python için Google API'leri İstemci Kitaplığı:
pip install --upgrade google-api-python-client
- Kullanıcı yetkilendirmesi için google-auth, google-auth-oauthlib ve google-auth-httplib2.
pip install --upgrade google-auth google-auth-oauthlib google-auth-httplib2
- Flask Python web uygulama çerçevesi (web sunucusu uygulamaları için Python örneklerini çalıştırıyorsanız).
pip install --upgrade flask
- İstek HTTP kitaplığı.
pip install --upgrade requests
Projenizi oluşturma ve kod örnekleri çalıştırma
-
API Konsolu'nda bir proje oluşturun ve Google API Konsolu'nda OAuth 2.0 kimlik bilgilerini ayarlayın. Kimlik bilgilerinizi ayarlarken, Flask Python web uygulama çerçevesini kullanan örnekler için uygulama türünü Web uygulaması olarak ayarlayın ve bu kimlik bilgileri için yetkili yönlendirme URI'leri ayarlayın. Aksi takdirde, uygulama türünü Diğer olarak ayarlayın.
-
Kimlik bilgilerinizle ilişkilendirilen
client_secret.json
dosyasını yerel bir dosyaya kaydedin. -
Kod örneğinin tamamını
client_secret.json
dosyasıyla aynı dizinde bulunan yerel bir dosyaya kopyalayın (veya bu dosyanın konumunu doğru şekilde tanımlamak için örneği değiştirin.) -
Örneği komut satırından çalıştırın:
python sample.py
Web sunucusu uygulama örnekleri için not:
Web sunucusu uygulamaları için Python örneklerini çalıştırıyorsanız komut dosyasını çalıştırdığınızda bir yerel web sunucusu başlatılır. API isteğini fiilen yürütmek için bir tarayıcıda sunulan web sayfasına gitmeniz gerekir. Örneğin, Flask web uygulama çerçevesini kullanan Python örnekleri şuna benzer bir satır içerir:
app.run('localhost', 8080, debug=True)
Bu kod,http://localhost:8080
adresinde bir yerel web sunucusu başlatır. Ancak, tarayıcıdahttp://localhost:8080
adresine gerçekten gidene kadar komut dosyası, bir API isteğini yürütmeye çalışmaz. (Yerel sunucunuzun URL'si, yetkilendirme kimlik bilgileriniz için yetkili bir yönlendirme URI'si olarak da ayarlanmalıdır.) -
Çoğu örnekte bir şeyler
STDOUT
konumuna veya web uygulaması örnekleri için görüntülediğiniz web sayfasına yazdırılır. Oynatma listesi veya kanal bölümü oluşturma istekleri gibi veri yazan isteklerin etkilerini görmek için YouTube web sitesine de göz atabilirsiniz.
Ön koşullar
- Komut satırı arayüzü (KSA) ve JSON uzantısı yüklü olarak PHP 5.4 veya sonraki sürümler.
- Composer bağımlılık yönetimi aracı.
- PHP için Google API'leri İstemci Kitaplığı:
php composer.phar require google/apiclient:^2.0
Projenizi oluşturma ve kod örnekleri çalıştırma
-
API Konsolu'nda bir proje oluşturun ve Google API Konsolu'nda OAuth 2.0 kimlik bilgilerini ayarlayın. Kimlik bilgilerinizi ayarlarken uygulama türünü Other olarak ayarlayın.
-
Kimlik bilgilerinizle ilişkilendirilen
client_secret.json
dosyasını yerel bir dosyaya kaydedin. -
Kod örneğinin tamamını
client_secret.json
dosyasıyla aynı dizinde bulunan yerel bir dosyaya kopyalayın (veya bu dosyanın konumunu doğru şekilde tanımlamak için örneği değiştirin.) -
Örneği komut satırından çalıştırın:
php sample.php
-
Çoğu örnekte bir şeyler
STDOUT
konumuna veya web uygulaması örnekleri için görüntülediğiniz web sayfasına yazdırılır. Oynatma listesi veya kanal bölümü oluşturma istekleri gibi veri yazan isteklerin etkilerini görmek için YouTube web sitesine de göz atabilirsiniz.
Ön koşullar
- Ruby 2.0 veya sonraki sürümler
- Ruby için Google API'leri İstemci Kitaplığı:
gem install google-api-client
Projenizi oluşturma ve kod örnekleri çalıştırma
-
API Konsolu'nda bir proje oluşturun ve Google API Konsolu'nda OAuth 2.0 kimlik bilgilerini ayarlayın. Kimlik bilgilerinizi ayarlarken uygulama türünü Other olarak ayarlayın.
-
Kimlik bilgilerinizle ilişkilendirilen
client_secret.json
dosyasını yerel bir dosyaya kaydedin. -
Kod örneğinin tamamını
client_secret.json
dosyasıyla aynı dizinde bulunan yerel bir dosyaya kopyalayın (veya bu dosyanın konumunu doğru şekilde tanımlamak için örneği değiştirin.) -
Örneği komut satırından çalıştırın:
ruby sample.rb
-
Çoğu örnekte bir şeyler
STDOUT
konumuna veya web uygulaması örnekleri için görüntülediğiniz web sayfasına yazdırılır. Oynatma listesi veya kanal bölümü oluşturma istekleri gibi veri yazan isteklerin etkilerini görmek için YouTube web sitesine de göz atabilirsiniz.
-
API Konsolu'nda bir proje oluşturun ve Google API Konsolu'nda OAuth 2.0 kimlik bilgilerini ayarlayın. Kimlik bilgilerinizi ayarlarken uygulama türünü Other olarak ayarlayın.
-
Kimlik bilgilerinizle ilişkilendirilen
client_secret.json
dosyasını yerel bir dosyaya kaydedin. -
Kod örneğinin tamamını
client_secret.json
dosyasıyla aynı dizinde bulunan yerel bir dosyaya kopyalayın (veya bu dosyanın konumunu doğru şekilde tanımlamak için örneği değiştirin.) -
Örneği komut satırından çalıştırın:
go run sample.go
-
Çoğu örnekte bir şeyler
STDOUT
konumuna veya web uygulaması örnekleri için görüntülediğiniz web sayfasına yazdırılır. Oynatma listesi veya kanal bölümü oluşturma istekleri gibi veri yazan isteklerin etkilerini görmek için YouTube web sitesine de göz atabilirsiniz.
Ortak metin işlevlerini kullanma
Yukarıda belirtildiği gibi tam kod örnekleri, API isteklerini yetkilendirmek ve oluşturmak için ortak kod kullanır. Örneğin, Python örneklerindeki build_resource
işlevi, eklenebilecek veya güncellenebilecek bir kaynak oluşturmak için kaynak özelliklerini değerleriyle eşleyen bir sözlük kullanır. JavaScript, PHP, Ruby, Go ve Apps Komut Dosyası için benzer işlevler sağlanır.
Örneğin, aşağıdaki sekmeler, kaynakları oluşturmaya yönelik ortak metin işlevlerinin bir playlist
kaynağı oluşturmak için nasıl çağrılacağını gösterir. Ortak metin işlevlerinin, ne tür bir kaynak oluşturulduğunu bilmesine gerek olmadığını unutmayın.
function createResource(properties) { var resource = {}; var normalizedProps = properties; for (var p in properties) { var value = properties[p]; if (p && p.substr(-2, 2) == '[]') { var adjustedName = p.replace('[]', ''); if (value) { normalizedProps[adjustedName] = value.split(','); } delete normalizedProps[p]; } } for (var p in normalizedProps) { // Leave properties that don't have values out of inserted resource. if (normalizedProps.hasOwnProperty(p) && normalizedProps[p]) { var propArray = p.split('.'); var ref = resource; for (var pa = 0; pa < propArray.length; pa++) { var key = propArray[pa]; if (pa == propArray.length - 1) { ref[key] = normalizedProps[p]; } else { ref = ref[key] = ref[key] || {}; } } }; } return resource; } var resource = createResource({ 'snippet.title': 'Sample playlist ', 'snippet.description': 'This is a sample playlist description.', 'snippet.tags[]': 'JavaScript code, interactive', 'snippet.defaultLanguage': '', 'status.privacyStatus': 'private' }
# Build a resource based on a list of properties given as key-value pairs. # Leave properties with empty values out of the inserted resource. def build_resource(properties): resource = {} for p in properties: # Given a key like "snippet.title", split into "snippet" and "title", where # "snippet" will be an object and "title" will be a property in that object. prop_array = p.split('.') ref = resource for pa in range(0, len(prop_array)): is_array = False key = prop_array[pa] # Convert a name like "snippet.tags[]" to snippet.tags, but handle # the value as an array. if key[-2:] == '[]': key = key[0:len(key)-2:] is_array = True if pa == (len(prop_array) - 1): # Leave properties without values out of inserted resource. if properties[p]: if is_array: ref[key] = properties[p].split(',') else: ref[key] = properties[p] elif key not in ref: # For example, the property is "snippet.title", but the resource does # not yet have a "snippet" object. Create the snippet object here. # Setting "ref = ref[key]" means that in the next time through the # "for pa in range ..." loop, we will be setting a property in the # resource's "snippet" object. ref[key] = {} ref = ref[key] else: # For example, the property is "snippet.description", and the resource # already has a "snippet" object. ref = ref[key] return resource resource = build_resource({ 'snippet.title': 'Sample playlist ', 'snippet.description': 'This is a sample playlist description.', 'snippet.tags[]': 'Python code, interactive', 'snippet.defaultLanguage': '', 'status.privacyStatus': 'private'}
// Add a property to the resource. function addPropertyToResource(&$ref, $property, $value) { $keys = explode(".", $property); $is_array = false; foreach ($keys as $key) { // Convert a name like "snippet.tags[]" to "snippet.tags" and // set a boolean variable to handle the value like an array. if (substr($key, -2) == "[]") { $key = substr($key, 0, -2); $is_array = true; } $ref = &$ref[$key]; } // Set the property value. Make sure array values are handled properly. if ($is_array && $value) { $ref = $value; $ref = explode(",", $value); } elseif ($is_array) { $ref = array(); } else { $ref = $value; } } // Build a resource based on a list of properties given as key-value pairs. function createResource($properties) { $resource = array(); foreach ($properties as $prop => $value) { if ($value) { addPropertyToResource($resource, $prop, $value); } } return $resource; } $propertyObject = createResource(array( 'snippet.title' => 'Sample playlist ', 'snippet.description' => 'This is a sample playlist description.', 'snippet.tags[]' => 'Python code, interactive', 'snippet.defaultLanguage' => '', 'status.privacyStatus' => 'private'));
# Build a resource based on a list of properties given as key-value pairs. def create_resource(properties) resource = {} properties.each do |prop, value| ref = resource prop_array = prop.to_s.split(".") for p in 0..(prop_array.size - 1) is_array = false key = prop_array[p] if key[-2,2] == "[]" key = key[0...-2] is_array = true end if p == (prop_array.size - 1) if is_array if value == "" ref[key.to_sym] = [] else ref[key.to_sym] = value.split(",") end elsif value != "" ref[key.to_sym] = value end elsif ref.include?(key.to_sym) ref = ref[key.to_sym] else ref[key.to_sym] = {} ref = ref[key.to_sym] end end end return resource end resource = create_resource({ 'snippet.title': 'Sample playlist ', 'snippet.description': 'This is a sample playlist description.', 'snippet.tags[]': 'Ruby code, interactive', 'snippet.default_language': '', 'status.privacy_status': 'private'})
// Build an object from an object containing properties as key-value pairs function createResource(properties) { var res = {}; var normalizedProps = {}; for (var p in properties) { var value = properties[p]; if (p.substr(-2, 2) == '[]' && value) { var adjustedName = p.replace('[]', ''); normalizedProps[adjustedName] = value.split(','); } else { normalizedProps[p] = value; } } for (var p in normalizedProps) { if (normalizedProps.hasOwnProperty(p) && normalizedProps[p]) { var propArray = p.split('.'); var ref = res; for (var pa = 0; pa < propArray.length; pa++) { var key = propArray[pa]; if (pa == propArray.length - 1) { ref[key] = normalizedProps[p]; } else { ref = ref[key] = ref[key] || {}; } } }; } return res; } var resource = createResource({ 'snippet.title': 'Sample playlist ', 'snippet.description': 'This is a sample playlist description.', 'snippet.tags[]': 'Apps Script code, interactive', 'snippet.defaultLanguage': '', 'status.privacyStatus': 'private' });
func addPropertyToResource(ref map[string]interface{}, keys []string, value string, count int) map[string]interface{} { for k := count; k < (len(keys) - 1); k++ { switch val := ref[keys[k]].(type) { case map[string]interface{}: ref[keys[k]] = addPropertyToResource(val, keys, value, (k + 1)) case nil: next := make(map[string]interface{}) ref[keys[k]] = addPropertyToResource(next, keys, value, (k + 1)) } } // Only include properties that have values. if (count == len(keys) - 1 && value != "") { valueKey := keys[len(keys)-1] if valueKey[len(valueKey)-2:] == "[]" { ref[valueKey[0:len(valueKey)-2]] = strings.Split(value, ",") } else if len(valueKey) > 4 && valueKey[len(valueKey)-4:] == "|int" { ref[valueKey[0:len(valueKey)-4]], _ = strconv.Atoi(value) } else if value == "true" { ref[valueKey] = true } else if value == "false" { ref[valueKey] = false } else { ref[valueKey] = value } } return ref } func createResource(properties map[string]string) string { resource := make(map[string]interface{}) for key, value := range properties { keys := strings.Split(key, ".") ref := addPropertyToResource(resource, keys, value, 0) resource = ref } propJson, err := json.Marshal(resource) if err != nil { log.Fatal("cannot encode to JSON ", err) } return string(propJson) } func main() { properties := (map[string]string{ "snippet.title": "Sample playlist ", "snippet.description": "This is a sample playlist description.", "snippet.tags[]": "Go code, interactive", "snippet.defaultLanguage": "", "status.privacyStatus": "private", }) res := createResource(properties)
Mevcut kaynakları yükleyin
Mevcut bir kaynağı güncelleme isteğini test etmek için söz konusu kaynağın geçerli özellik değerlerini güncelleme formuna yükleyebilirsiniz. Örneğin, bir videoyla ilgili meta verileri güncellemek için id
özellik alanına video kimliğini girin ve Kaynak yükle düğmesini tıklayın. Geçerli özellik değerleri forma yüklenir ve yalnızca değiştirmek istediğiniz değerleri güncelleyebilirsiniz.
![](https://developers.google.cn/static/youtube/images/interactive-snippet-load-resource.png?authuser=19&hl=tr)