YouTube API Hizmetleri - Gerekli Minimum İşlevler

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ığı.
  • Yorum bir kanalla ilgiliyse API istemcisinin, kanalın adını göstermesi gerekir.
  • Yorum bir videoyla ilgiliyse API istemcisi, videoyu yükleyen kanalın adını görüntülemelidir.
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ığı.
  • Kullanıcı bir kanal hakkında yorum ekliyorsa API istemcisi, kanalın adını göstermelidir.
  • Kullanıcı bir video hakkında yorum ekliyorsa API istemcisi, videoyu yükleyen kanalın adını görüntülemelidir.
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ığı.
  • Kullanıcı bir kanalla ilgili yorumu yanıtlıyorsa API istemcisi, kanalın adını göstermelidir.
  • Kullanıcı bir videoyla ilgili yoruma yanıt veriyorsa API istemcisi, videoyu yükleyen kanalın adını görüntülemelidir.
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ığı.
  • Kullanıcı bir kanal hakkındaki yorumu düzenliyor veya siliyorsa API istemcisinin kanalın adını göstermesi gerekir.
  • Kullanıcı bir video hakkındaki yorumu düzenliyor veya siliyorsa API istemcisi, videoyu yükleyen kanalın adını göstermelidir.
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.