Not: YouTube Geliştirici Politikaları'na uygunluk, API istemcilerinizin YouTube API Hizmetleri Hükümleri ve Politikaları'nın (API Hizmet Şartları) belirli bölümlerine uymasını sağlamanıza yardımcı olacak rehberlik ve örnekler sunar. Kılavuz, YouTube'un API Hükümler ve Koşulları'nın belirli yönlerini nasıl uyguladığı hakkında bilgi verir ancak mevcut dokümanların yerini almaz.
Bu dokümanda, YouTube API hizmetlerinin belirli özelliklerini uygulayan veya bu özelliklere erişim sağlayan API istemcileri ("API istemcileri") için minimum işlevsel gereksinimler tanımlanmaktadır.
Bu şartlar ve yönergeler, API istemcilerinin YouTube kullanıcılarının, içerik sahiplerinin ve reklamverenlerin çıkarlarını koruyan tutarlı bir kullanıcı deneyimi sunmasını sağlar. Bu kurallar, YouTube API Hizmet Şartları'nın ayrılmaz bir parçasıdır ve API istemcilerinin geliştirilmesi ve uygulanmasında uyulması gerekir.
Mevcut YouTube özellikleriyle daha iyi kullanıcı deneyimleri sunabilmek için bu belgedeki şartların değişmesini bekleyebilirsiniz. Ayrıca, yeni ve güncellenmiş YouTube özelliklerine göre de değişir. Bu tür değişiklikler, API istemcilerinizi yeni koşulları karşılayacak şekilde güncellemenizi gerektirebilir. Hizmet Şartları düzeltme geçmişinde tüm değişiklikler belgelenir. Bu nedenle, API istemcilerinizi etkileyebilecek değişiklikler hakkında hızlı bir şekilde bilgi edinmek için lütfen bu dokümanı sık sık kontrol edin veya RSS özet akışına abone olun.
Bu dokümanda belirtilen şartlara ek olarak, YouTube API Hizmetleri Politikaları'nda açıklanan ve YouTube API Hizmetleri dokümanlarında başka yerlerde ele alınan en iyi uygulamaları uygulamanızı önemle tavsiye ederiz. Bu uygulamalar, zorunlu olmasa bile API istemcilerinizin hatalardan daha hızlı kurtulmasına ve kota tahsis eden YouTube API hizmetlerini kullanıyorlarsa kota kullanımlarını optimize etmelerine yardımcı olur. Bu uygulamalar aynı zamanda YouTube ekosisteminin sağlıklı kalmasına ve her şeyden önce API istemcilerinizin ve YouTube uygulamalarınızın kullanıcılarına mümkün olan en iyi deneyimi sunmanıza yardımcı olur.
YouTube yerleşik oynatıcı ve video oynatma
Bu bölümdeki şartlar, özellikle yerleştirilmiş YouTube oynatıcılarıyla ilgilidir. YouTube API Hizmetleri Politikaları, YouTube'da işitsel ve görsel içerik oynatan API istemcileriyle ilgili çeşitli politikaları da içerir.
Yerleştirilmiş YouTube oynatıcısı boyutu
Yerleşik oynatıcıların en az 200 piksele 200 piksel değerinde bir görünüme sahip olması gerekir. Oynatıcı kontrolleri gösterirse görünümün minimum boyutun altına düşürmeksizin kontrolleri tamamen gösterecek kadar geniş olması gerekir. En az 480 piksel genişlik, 270 piksel uzunluğa sahip 16:9 oynatıcıları öneririz.
Otomatik oynatma ve komut dosyası oynatmaları
Bu bölümde otomatik oynatma işlemleri ele alınmaktadır. Bu politika, autoplay oynatıcı parametresini kullanan veya YouTube IFrame Player API hizmetini ya da başka bir YouTube API hizmetini kullanarak otomatik oynatmayı programatik olarak başlatan YouTube yerleşik oynatıcıları için geçerlidir.
-
Videoyu otomatik olarak oynatan yerleşik oynatıcılar, sayfa yüklendiğinde veya yerleşik oynatıcı tamamen görünür hale gelir gelmez oynatmayı başlatmalıdır. Ancak API istemcisi, oynatıcı görünür ve oynatıcının yarısından fazlası sayfa veya ekranda görünene kadar otomatik oynatma işlemi başlatmamalıdır.
-
Bir sayfa veya ekranda, aynı anda otomatik olarak içerik oynatan birden fazla YouTube oynatıcı olmamalıdır.
-
Oynatma işlemi başlatan YouTube küçük resimleri en az 120 piksel genişliğinde ve 70 piksel yüksekliğinde olmalıdır.
YouTube Oynatıcı özellikleri
YouTube oynatıcının özellikleri ve parametreleri (ör. oynatıcıda YouTube markasının görünümü) YouTube API dokümanlarında ve spesifikasyonlarında (https://developers.google.com/youtube) belirtilmiştir. YouTube oynatıcısında, API dokümanlarında açıkça açıklanmayan değişiklikler yapmanız yasaktır.
Yer paylaşımları ve çerçeveler
Oynatıcı kontrolleri dahil olmak üzere YouTube yerleşik oynatıcının herhangi bir bölümünün önüne yer paylaşımları, çerçeveler veya başka görsel öğeler yerleştiremezsiniz. Benzer şekilde, yerleştirilmiş bir oynatıcının herhangi bir bölümünü (oynatıcı kontrolleri dahil) gizlemek için yer paylaşımları, çerçeveler veya diğer görsel öğeleri kullanmamanız gerekir.
Fare üzerine getirildiğinde etkinleşen öğeler
Kullanıcı adına pencere açma veya kanala abone olma gibi bir işlem başlatmak için YouTube oynatıcısında fareyle üzerine gelme veya dokunma etkinlikleri kullanmamalısınız.
Video yükleme
API istemcileri kullanıcıların birden fazla platforma içerik yüklemesine izin veriyorsa kullanıcılar videolarını yüklemek istedikleri platformları seçip seçimini kaldırabilmelidir.
Veri gereksinimleri
Kullanıcıların YouTube'a video yüklemelerine olanak tanıyan API istemcileri, aşağıdaki listedeki değerleri ayarlamak için users öğesini etkinleştirmelidir. Listede yer almayan özellikler isteğe bağlıdır.
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.title |
Zorunludur. Videonun başlığı. Değer 100 karakteri aşarsa YouTube hata döndürür. YouTube, < ve > hariç tüm geçerli UTF-8 karakterlerini destekler.
| |
snippet.description |
Zorunludur. Videonun açıklaması. Değer 5.000 baytı aşarsa YouTube hata döndürür. YouTube, < ve > hariç tüm geçerli UTF-8 karakterlerini destekler. |
|
status.privacyStatus |
Zorunludur. Videonun gizlilik ayarı. Kullanıcılar, yüklenen videonun herkese açık, gizli veya liste dışı olmasını seçebilmelidir. | |
| İstek parametreleri | ||
onBehalfOfContentOwnerChannel |
Koşullu olarak zorunludur. İsteğin yetkilendirme kimlik bilgileri bir içerik sahibini tanımlarsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısı, videonun yüklendiği YouTube kanalını da belirtebilmelidir. |
|
Yorumları gösterme
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.textDisplay |
Zorunludur. Yorumun metni. API istemcisi, (a) bir yorumun veya yorum yanıtının tam metnini göstermeli ya da (b) metni kısaltmalı ve görüntüleyenin kısaltılmış sürümden tam metne kolayca erişebileceği bir yöntem sağlamalıdır. Bu şart, yorumların ilişkili olduğu kaynak türüne (videolar, kanallar vb.) bakılmaksızın tüm yorumlar ve yorum yanıtları için geçerlidir. commentThread kaynağının snippet.topLevelComment mülk değerinin bir comment kaynağı olduğunu ve replies.comments[] mülkünün bir comment kaynağı listesi olduğunu unutmayın. Bu nedenle, bu şart snippet.topLevelComment.snippet.textDisplay ve replies.comments[].snippet.textDisplay mülkleri için de geçerlidir. |
|
snippet.title( channel) |
Zorunlu (öneri). Kanalın başlığı.
|
|
snippet.title( video) |
Koşullu olarak gerekli (öneri). Videonun başlığı. Yorum bir videoyla ilgiliyse bu değer gösterilmelidir. | |
snippet.moderationStatus |
Koşullu olarak zorunludur. API isteğinde moderationStatus parametresi değeri heldForReview veya likelySpam ise ekranda, özellik değeri, benzer bir dil (ör. "Bu yorum incelenmek üzere beklemede"), bir başlık (ör. "İncelenmek üzere beklemede") veya net bir dil kullanılarak bu durum açıkça belirtilmelidir. commentThreads.list yöntemi, yorumları moderasyon durumlarına göre alma özelliğini destekler. |
|
Yorum ekleme
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.title( channel) |
Zorunludur. Kanalın başlığı.
|
|
snippet.title( video) |
Zorunludur. Kullanıcı bir videoyla ilgili yorum ekliyorsa API istemcisi videonun başlığını göstermelidir. | |
| Diğer koşullar | ||
Comment author's channel name |
Zorunludur. API istemcisi, yorumun ilişkilendirileceği YouTube kullanıcı hesabını açıkça tanımlamalıdır. İsteğin yetkilendirme kimlik bilgileri bir içerik sahibini tanımlarsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısı, yorumun ilişkilendirileceği YouTube kanalını da belirtebilmelidir. |
|
Yorum yanıtları ekleme
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.textDisplay |
Zorunludur. Yorumun metni. API istemcisi, kullanıcının yanıtladığı yorumun metnini bu dokümanın Yorumları görüntüleme bölümünde tanımlanan kurallara uygun şekilde göstermelidir. | |
snippet.title( channel) |
Zorunludur. Kanalın başlığı.
|
|
snippet.title( video) |
Zorunludur. Kullanıcı bir videoyla ilgili yorumu yanıtlıyorsa API istemcisi videonun başlığını göstermelidir. | |
| Diğer koşullar | ||
Comment author's channel name |
Zorunludur. API istemcisi, yorum yanıtının ilişkilendirileceği YouTube kullanıcı hesabını açıkça tanımlamalıdır. İsteğin yetkilendirme kimlik bilgileri bir içerik sahibini tanımlayıp onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısının, yorum yanıtının ilişkilendirileceği YouTube kanalını da belirtmesi gerekir. |
|
Yorum yanıtlarını düzenleme veya silme
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.textDisplay |
Zorunludur. Yorumun metni. API istemcisi, kullanıcının düzenlediği veya sildiği yorumun metnini bu dokümanın Yorumları görüntüleme bölümünde tanımlanan kurallara uygun şekilde göstermelidir. | |
snippet.title( channel) |
Zorunludur. Kanalın başlığı.
|
|
snippet.title( video) |
Zorunludur. Kullanıcı bir videoyla ilgili yorumu düzenleyip siliyorsa API istemcisi videonun başlığını göstermelidir. | |
| Diğer koşullar | ||
Comment author's channel name |
Zorunludur. API istemcisi, yorumun ilişkilendirildiği YouTube kullanıcı hesabını açıkça tanımlamalıdır. | |
Kullanıcıları canlı sohbetten yasaklama (veya yasakları kaldırma)
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.title( channel) |
Zorunludur. Engellenen veya engellemesi kaldırılan YouTube kanalının adı. Ayrıca, ad kanala bağlantı vermelidir veya kanal URL'si de gösterilmelidir. | |
| Diğer koşullar | ||
| Yorum yazarının kanal adı | Zorunludur. API istemcisi, yasak eklemek veya kaldırmak için kullanılan YouTube kullanıcı hesabını açıkça tanımlamalıdır. | |