Watermarks: set

YouTube'a filigran resmi yükler ve bunu bir kanal için ayarlar.

Bu yöntem, medya yüklemeyi destekler. Yüklenen dosyalar şu kısıtlamalara uymalıdır:

  • Maksimum dosya boyutu: 10 MB
  • Kabul edilen medya MIME türleri: image/jpeg, image/png, application/octet-stream

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 50 birimdir.

İstek

HTTP isteği

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

Yetkilendirme

Bu istek için aşağıdaki kapsamların en az biriyle yetkilendirme yapılması gerekir. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 yetkilendirmesini uygulama başlıklı makaleyi inceleyin.

Kapsam
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
channelId string
channelId parametresi, filigranın sağlandığı YouTube kanalının kimliğini belirtir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi ve yöneticisi olan YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamak zorunda kalmadan tek bir kimlik doğrulama işlemiyle tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek metni

İstek gövdesinde bir watermark kaynağı sağlayın. Kaynak aşağıdaki özellikleri içerir:

  • timing (object, zorunlu): Filigranın gösterilme zamanını kapsar.
    • timing.type (string, zorunlu): offsetFromStart veya offsetFromEnd olarak ayarlayın.
    • timing.offsetMs (unsigned long, zorunlu): Başlangıç farkı (milisaniye). type, offsetFromEnd ise en az 1000 ms olmalıdır.
    • timing.durationMs (unsigned long, isteğe bağlı): Milisaniye cinsinden görünür süre (minimum 1000 ms). type değeri offsetFromEnd ise offsetMs değerini aşmamalıdır.
  • targetChannelId (string, isteğe bağlı): Filigranın bağlandığı YouTube kanal kimliği. Atlanırsa channelId ile tanımlanan kanala bağlantı verilir.
  • position (object, kullanımdan kaldırıldı): YouTube tarafından dikkate alınmaz. Filigranlar her zaman sağ üst köşeye yerleştirilir.

Yanıt

Başarılı olursa bu yöntem bir HTTP 204 No Content durum kodu döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için YouTube Data API - Hatalar başlıklı makaleyi inceleyin.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) imageFormatUnsupported Sağladığınız resim desteklenmeyen bir biçimde.
badRequest (400) imageTooTall Gönderdiğiniz resim çok uzun.
badRequest (400) imageTooWide Gönderdiğiniz resim çok geniş.
badRequest (400) mediaBodyRequired İstek, resim içeriğini içermiyor.
forbidden (403) forbidden Filigran, belirtilen kanal için ayarlanamaz. İstek düzgün şekilde yetkilendirilmemiş olabilir veya channelId parametresi geçersiz bir değere ayarlanmış olabilir.

Deneyin.

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.