Not: Yeni YouTube Geliştirici Politikaları'na uygunluk rehberi, API müşterilerinizin YouTube API Hizmetleri Şartları ve Politikalar'ın (API Hizmet Şartları) belirli bölümlerine uymasını sağlamanıza yardımcı olacak yol gösterici bilgiler ve örnekler sunar. Bu rehber, YouTube'un API Hizmet Şartları'nın belirli yönlerini nasıl uyguladığına ilişkin mevcut bilgiler sunar ancak mevcut dokümanların yerini almaz.
Bu belge, YouTube API hizmetlerinin belirli özelliklerini ("API İstemcileri") uygulayan veya bunlara erişim sağlayan API istemcileri için minimum işlevsel şartları tanımlar.
Bu şartlar ve kurallar, 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 tüm API İstemcilerinin geliştirilmesi ve uygulanmasında uygulanmalıdır.
Mevcut YouTube özellikleriyle daha iyi bir kullanıcı deneyimi sunabilmemiz için bu dokümandaki koşulların değişeceğini düşünüyorsunuz. Ayrıca, yeni ve güncellenmiş YouTube özelliklerine bağlı olarak da değişecektirler. Bazı durumlarda bu tür değişikliklerin yapılması için API İstemcilerinizi güncellemeniz gerekebilir. Hizmet Şartları düzeltme geçmişi, değişiklikleri belgelendirecektir. Bu nedenle, söz konusu dokümanı sık sık kontrol edin veya API İstemcilerinizi etkileyebilecek değişiklikler hakkında hızlıca bilgi edinebilmek için RSS özet akışına abone olun.
Bu belgedeki koşullara ek olarak, YouTube API Hizmetleri Politikaları'nda açıklanan ve YouTube API hizmetleri dokümanlarının diğer bölümlerinde ele alınan en iyi uygulamaları izlemenizi önemle tavsiye ederiz. Bu uygulamalar kesinlikle gerekli olmasa bile, API İstemcilerinizin hatadan daha hızlı kurtulmasına ve kota ayıran YouTube API hizmetlerini kullanıyorlarsa kota kullanımlarını optimize etmelerine yardımcı olur. Aynı zamanda bu uygulamalar, YouTube ekosisteminin sağlıklı olmasını sağlamaya ve her şeyden önce API İstemcilerinizin ve YouTube Uygulamalarınızın kullanıcılarına mümkün olan en iyi deneyimi sağlamaya yardımcı olur.
YouTube'a yerleştirilmiş oynatıcı ve video oynatma
Bu bölümdeki koşullar özellikle yerleşik YouTube oynatıcılarıyla ilgilidir. YouTube API Hizmetleri Politikaları, YouTube'un görsel-işitsel içeriğini oynatan API İstemcileriyle ilgili çeşitli politikalar da içerir.
Yerleşik 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 senaryolu oynatmalar
Bu bölümde otomatik oynatmalar ele alınmaktadır. autoplay
oynatıcı parametresini kullanan veya YouTube IFrame Player API hizmetini, YouTube Android Player API hizmetini veya başka bir YouTube API hizmetini kullanarak otomatik olarak oynatma işlemini başlatan yerleşik YouTube oynatıcıları için geçerlidir.
-
Bir videoyu otomatik olarak oynatan yerleşik oynatıcılar, sayfa yüklenir yüklenmez veya yerleşik oynatıcı tamamen görünür olur olmaz oynatmayı başlatmalıdır. Ancak API İstemcisi, oynatıcı görünene ve oynatıcının yarısından fazlası sayfa veya ekranda görünene kadar otomatik oynatma başlatmamalıdır.
-
Bir sayfa veya ekranda, içeriği aynı anda otomatik olarak oynatan birden fazla YouTube oynatıcısı olmamalıdır.
-
Oynatma başlatan YouTube küçük resimleri en az 120 piksel genişliğinde ve 70 piksel yüksekliğinde olmalıdır.
YouTube Player özellikleri
YouTube markasının oynatıcıdaki görünümü gibi YouTube oynatıcısının özellikleri ve parametreleri, YouTube API dokümanlarında ve spesifikasyonlarında (https://developers.google.com/youtube) belirtilir. YouTube oynatıcısında, API belgelerinde açıkça belirtilmeyen değişiklikler yapmamalısınız.
Yer paylaşımları ve çerçeveler
Yer paylaşımlı oynatıcılar, çerçeveler veya diğer görsel öğeleri, oynatıcı kontrolleri dahil olmak üzere YouTube'un yerleşik oynatıcısının herhangi bir kısmının önünde göstermemelisiniz. Benzer şekilde, oynatıcı kontrolleri dahil olmak üzere yerleştirilmiş bir oynatıcının herhangi bir bölümünü kapatmak 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 herhangi bir işlem (ör. pencere açma veya kanala abone olma) başlatmak için YouTube oynatıcısının üzerine fareyle gelme veya dokunma etkinlikleri kullanmamalısınız.
Video yükleme
API İstemcileri, kullanıcıların birden fazla platforma içerik yüklemesine izin veriyorsa videolarını yüklemek istedikleri platformları seçebilme ve seçimlerini kaldırabilmelidir.
Veri gereksinimleri
Kullanıcıların YouTube'a video yüklemesine olanak tanıyan API istemcileri, aşağıdaki listede bulunan değerleri kullanıcıların belirlemesi için etkinleştirilmelidir. Listede olmayan tesisler isteğe bağlıdır.
Ad | Açıklama | |
---|---|---|
Kaynak mülkler | ||
snippet.title |
Required. Videonun başlığı. Değer 100 karakteri aşıyorsa YouTube hata verir. YouTube, < ve > haricindeki tüm geçerli UTF-8 karakterlerini destekler.
| |
snippet.description |
Required. Videonun açıklaması. Değer 5.000 baytı aşarsa YouTube hata verir. YouTube, < ve > haricindeki tüm geçerli UTF-8 karakterlerini destekler. |
|
status.privacyStatus |
Required. Videonun gizlilik ayarı. Kullanıcılar, yüklenen videonun herkese açık mı, gizli mi yoksa liste dışı mı olacağını seçebilmelidir. | |
İstek parametreleri | ||
onBehalfOfContentOwnerChannel |
Koşula bağlı olarak zorunludur. İsteğin yetkilendirme kimlik bilgileri bir içerik sahibi belirtiyorsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısı, videonun yüklendiği YouTube kanalını da belirtebilmelidir. |
Yorumlar gösteriliyor
Ad | Açıklama | |
---|---|---|
Kaynak mülkler | ||
snippet.textDisplay |
Required. Yorumun metni. API istemcisi (a) yorum veya yorum yanıtının tam metnini görüntülemeli ya da (b) metni kısaltıp izleyicinin kısaltılmış sürümden tam metne kolayca erişebilmesi için bir yol sağlamalıdır. Yorumların ilişkili olduğu kaynak türü (videolar, kanallar vb.) ne olursa olsun tüm yorumlar ve yorum yanıtları için geçerli olur. commentThread kaynağının snippet.topLevelComment mülk değerinin bir comment kaynağı ve comment kaynağı olduğunu unutmayın. Bu nedenle, bu koşul 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şula bağlı olarak önerilir (öneri). Videonun başlığı. Yorum bir videoyla ilgiliyse bu değer görüntülenmelidir. | |
snippet.moderationStatus |
Koşula bağlı olarak zorunludur. API isteğindeki moderationStatus parametre değeri heldForReview veya likelySpam ise ekran, mülk değerini, benzer dili (ör. "Bu yorum inceleme için bekletiliyor"), bir başlığı (ör. "İnceleme için bekletilenler") kullanarak veya başka bir dil kullanarak bu durumu açıkça tanımlamalıdır. commentThreads.list yöntemi, moderasyon durumuna göre yorumları alma özelliğini destekler. |
Yorum ekleme
Ad | Açıklama | |
---|---|---|
Kaynak mülkler | ||
snippet.title ( channel ) |
Required. Kanalın başlığı.
|
|
snippet.title ( video ) |
Required. Kullanıcı bir videoyla ilgili yorum ekliyorsa API istemcisi, videonun başlığını görüntülemelidir. | |
Diğer şartlar | ||
Comment author's channel name |
Required. 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 sahibi belirtiyorsa 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 mülkler | ||
snippet.textDisplay |
Required. Yorumun metni. API istemcisi, bu dokümanın Yorumları görüntüleme bölümünde tanımlanan kurallara uygun olarak, kullanıcının yanıtladığı yorumun metnini görüntülemelidir. | |
snippet.title ( channel ) |
Required. Kanalın başlığı.
|
|
snippet.title ( video ) |
Required. Kullanıcı bir videoyla ilgili yorumu yanıtlıyorsa API istemcisi, videonun başlığını görüntülemelidir. | |
Diğer şartlar | ||
Comment author's channel name |
Required. 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 sahibi belirtiyorsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısı, yorum yanıtının ilişkilendirileceği YouTube kanalını da belirtebilmelidir. |
Yorum yanıtlarını düzenleme veya silme
Ad | Açıklama | |
---|---|---|
Kaynak mülkler | ||
snippet.textDisplay |
Required. 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 belirtilen kurallara uygun şekilde göstermelidir. | |
snippet.title ( channel ) |
Required. Kanalın başlığı.
|
|
snippet.title ( video ) |
Required. Kullanıcı bir videoyla ilgili yorumu düzenliyor veya siliyorsa API istemcisi videonun başlığını görüntülemelidir. | |
Diğer şartlar | ||
Comment author's channel name |
Required. API istemcisi, yorumun ilişkilendirildiği YouTube kullanıcı hesabını açıkça tanımlamalıdır. |
Bir kullanıcıyı canlı sohbette yasaklama (veya yasaklamayı kaldırma)
Ad | Açıklama | |
---|---|---|
Kaynak mülkler | ||
snippet.title ( channel ) |
Required. Yasaklanan veya yasağı kaldırılan YouTube kanalının adı. Ayrıca, adın kanala bağlanması veya kanal URL'sinin gösterilmesi gerekir. | |
Diğer şartlar | ||
Yorum yazarının kanal adı | Required. API istemcisi, yasak eklemek veya kaldırmak için kullanılan YouTube kullanıcı hesabını açıkça tanımlamalıdır. |