Not: YouTube Geliştirici Politikaları'na uygunluk, API müşterilerinizin YouTube API Hizmetleri Şartları ve Politikaları'nın (API Hizmet Şartları) belirli bölümlerine uymasını sağlamanıza yardımcı olacak kılavuz ve örnekler sağlar. Kılavuz, YouTube'un API Hizmet Şartları'nın belirli özelliklerini nasıl uyguladığına ilişkin bilgiler sağlar ancak mevcut dokümanların yerini almaz.
Bu belgede, YouTube API hizmetlerinin belirli özelliklerini ("API İstemcileri") uygulayan veya bu özelliklere erişim sağlayan API istemcileri için minimum işlevsel gereksinimler açıklanmaktadır.
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ştirilip uygulanması sırasında uyulması gerekir.
Mevcut YouTube özellikleriyle ilgili daha iyi kullanıcı deneyimleri sağlayabilmemiz için bu belgedeki şartların değişmesi beklenir. Bu politikalar, yeni ve güncellenen YouTube özelliklerine göre de değişecektir. Zaman zaman bu tür değişiklikler nedeniyle API İstemcilerinizi yeni gereksinimleri karşılayacak şekilde güncellemeniz gerekebilir. Tüm değişiklikler, Hizmet Şartları düzeltme geçmişinde belgelenecektir. Bu nedenle, API İstemcilerinizi etkileyebilecek değişiklikler hakkında hızlı bir şekilde bilgi edinebilmek için lütfen bu dokümanı sık sık kontrol edin veya RSS özet akışına abone olun.
Bu belgedeki şartlara ek olarak, YouTube API Hizmetleri Politikaları'nda açıklanan ve YouTube API hizmetleri belgelerinin diğer bölümlerinde de açıklanan en iyi uygulamaları izlemenizi önemle tavsiye ederiz. Kesinlikle gerekli olmadığında bile bu uygulamalar, API İstemcilerinizin hatalardan daha hızlı kurtulmalarına ve kota tahsis eden YouTube API hizmetlerini kullandıklarında kota kullanımlarını optimize etmelerine yardımcı olur. Aynı zamanda bu uygulamalar, YouTube ekosisteminin sağlıklı olmasına ve en önemlisi de API istemcilerinizin ve YouTube uygulamalarınızın kullanıcılarına mümkün olan en iyi deneyimin sunulmasına yardımcı olur.
Yerleştirilmiş YouTube oynatıcısı ve video oynatma
Bu bölümdeki şartlar özellikle yerleştirilmiş YouTube oynatıcılarıyla ilgilidir. YouTube API Hizmetleri Politikaları, YouTube'da görsel-işitsel içerikleri oynatan API İstemcileri ile 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ıyla oynatma
Bu bölümde otomatik oynatmalar ele alınmaktadır. autoplay oynatıcı parametresini kullanan ya da YouTube IFrame Player API hizmetini, YouTube Android Player API hizmetini veya başka bir YouTube API hizmetini kullanarak programatik olarak otomatik oynatmayı başlatan yerleştirilmiş YouTube oynatıcıları için geçerlidir.
-
Otomatik olarak video oynatan gömülü oynatıcılar, sayfa yüklendiğinde hemen veya yerleşik oynatıcı tamamen görünür hale gelir gelmez oynatmayı başlatmalıdır. Bununla birlikte, oynatıcı görünür olana ve oynatıcının yarısından fazlası sayfada veya ekranda görünene kadar API İstemcisi 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.
-
Oynatmayı başlatan YouTube küçük resimleri en az 120 piksel genişliğinde ve 70 piksel uzunluğunda olmalıdır.
YouTube Oynatıcısı özellikleri
YouTube oynatıcısının özellikleri ve parametreleri (örneğin, YouTube markasının oynatıcıda görünmesi) YouTube API dokümanlarında ve spesifikasyonlarında (https://developers.google.com/youtube) belirtilmiştir. YouTube oynatıcısında, API belgelerinde açıkça açıklanmayan değişiklikler yapmamalısınız.
Yer paylaşımları ve çerçeveler
Yer paylaşımlı reklamlar, çerçeveler veya diğer görsel öğeleri, oynatıcı kontrolleri de dahil olmak üzere YouTube yerleşik oynatıcısının hiçbir bölümünde göstermemelisiniz. Benzer şekilde, oynatıcı kontrolleri de dahil olmak üzere yerleştirilmiş oynatıcının herhangi bir bölümünü gizlemek için yer paylaşımları, çerçeveler veya diğer görsel öğeler kullanmamalısınız.
Fare üzerine getirildiğinde etkinleşen öğeler
Bir YouTube oynatıcısında fareyle üzerine gelme veya dokunma etkinliklerini, kullanıcı adına herhangi bir işlem (pencere açma ya da bir kanala abone olma gibi) başlatmak için kullanmamalısınız.
Video yükleme
API İstemcileri, kullanıcıların birden fazla platforma içerik yüklemesine izin veriyorsa kullanıcılar videolarını yüklemek istedikleri platformları seçebilmeli ve bunların seçimini kaldırabilmelidir.
Veri gereksinimleri
Kullanıcıların YouTube'a video yükleyebilmesini sağlayan API istemcileri, users (kullanıcıların) aşağıdaki listede bulunan değerleri belirleyebilmesini sağlamalıdır. Listelenmeyen tüm tesisler 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 > dışındaki geçerli tüm 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 > dışındaki geçerli tüm 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şula bağlı olarak zorunludur. İsteğin yetkilendirme kimlik bilgileri bir içerik sahibini tanımlıyorsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısının, videonun yüklendiği YouTube kanalını da belirtebilmesi gerekir. |
|
Yorumları görüntüleme
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.textDisplay |
Zorunludur. Yorumun metni. API istemcisi, (a) bir yorumun veya yorum yanıtının tam metnini görüntülemeli ya da (b) metni kısaltarak izleyicinin kısaltılmış sürümdeki metnin tamamına kolayca erişebilmesi için bir yöntem sunmalıdır. Bu koşul, yorumların ilişkilendirildiği kaynağın türünden (videolar, kanallar vb.) bağımsız olarak tüm yorumlar ve yorum yanıtları için geçerlidir. commentThread kaynağının snippet.topLevelComment özellik değerinin comment kaynağı ve replies.comments[] özelliği olduğunu unutmayın.comment Dolayısıyla bu koşul snippet.topLevelComment.snippet.textDisplay ve replies.comments[].snippet.textDisplay özellikleri için de geçerlidir. |
|
snippet.title( channel) |
Zorunlu (öneri). Kanalın başlığı.
|
|
snippet.title( video) |
Koşula bağlı olarak zorunludur (öneri). Videonun başlığı. Bu değer, yorum bir videoyla ilgiliyse gösterilmelidir. | |
snippet.moderationStatus |
Koşula bağlı olarak zorunludur. API isteğindeki moderationStatus parametre değeri heldForReview veya likelySpam ise ekranda bu durum; özellik değeri, benzer dil (ör. "Bu yorum inceleme için bekletiliyor"), başlık (ör. "İnceleme için bekletiliyor") veya açık olmayan başka bir dil kullanılarak belirtilmelidir. commentThreads.list yöntemi, yorumları denetleme durumuna 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 video hakkında yorum ekliyorsa API istemcisinin videonun başlığını göstermesi gerekir. | |
| 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ımlıyorsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısının, yorumun ilişkilendirileceği YouTube kanalını da belirtebilmesi gerekir. |
|
Yorum yanıtları ekleniyor
| 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 olarak görüntülemelidir. | |
snippet.title( channel) |
Zorunludur. Kanalın başlığı.
|
|
snippet.title( video) |
Zorunludur. Kullanıcı bir videoyla ilgili yorumu yanıtlıyorsa API istemcisinin videonun başlığını göstermesi gerekir. | |
| 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ımlıyorsa ve onBehalfOfContentOwner parametresi ayarlanmışsa API kullanıcısının, yorum yanıtının ilişkilendirileceği YouTube kanalını da belirtebilmesi gerekir. |
|
Yorum yanıtlarını düzenleme veya silme
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.textDisplay |
Zorunludur. Yorumun metni. API istemcisi, bu dokümanın Yorumları görüntüleme bölümünde tanımlanan kurallara göre kullanıcının düzenlediği veya sildiği yorumun metnini görüntülemelidir. | |
snippet.title( channel) |
Zorunludur. Kanalın başlığı.
|
|
snippet.title( video) |
Zorunludur. Kullanıcı bir videoyla ilgili yorumu düzenliyor veya siliyorsa API istemcisinin videonun başlığını göstermesi gerekir. | |
| 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. | |
Bir kullanıcıyı canlı sohbette yasaklama (veya yasağı kaldırma)
| Ad | Açıklama | |
|---|---|---|
| Kaynak özellikleri | ||
snippet.title( channel) |
Zorunludur. Yasaklanan veya yasağı kaldırılan YouTube kanalının adı. Ayrıca, adın kanala bağlanması veya kanal URL'sinin görüntülenmesi gerekir. | |
| Diğer koşullar | ||
| Yorumu yazan kullanıcının kanal adı | Zorunludur. API istemcisi, yasağı eklemek veya kaldırmak için kullanılan YouTube kullanıcı hesabını açıkça tanımlamalıdır. | |