YouTube Data API - Errors

Bu belgede, YouTube Data API işlemlerinin döndürebileceği farklı hata türleri tanımlanmaktadır. Ayrıca, belirli bir yönteme ilişkin hata listesini ilgili yöntemin referans belgelerinde bulabilirsiniz.

Genel hatalar

Aşağıdaki tablolarda, belirli bir API yöntemine özgü olmayan API hata mesajları tanımlanmaktadır.

Core API errors

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	Erişim yasak. İstek düzgün şekilde yetkilendirilmemiş olabilir.
quotaExceeded (403)	quotaExceeded	Kotanızı aştığınız için istek tamamlanamıyor.

Common request errors

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	incompatibleParameters	İstek, aynı istekte kullanılamayan iki veya daha fazla parametre belirtiyor.
badRequest (400)	invalidFilters	İstek, geçersiz bir filtre parametresi belirtiyor.
badRequest (400)	invalidPageToken	İstek, geçersiz bir sayfa jetonu belirtiyor.
badRequest (400)	missingRequiredParameter	İstekte gerekli bir parametre eksik.
badRequest (400)	unexpectedParameter	İstek, beklenmeyen bir parametre belirtiyor.
forbidden (403)	accountDelegationForbidden	Kimliği doğrulanmış kullanıcı, belirtilen Google Hesabı adına işlem yapamaz.
forbidden (403)	authenticatedUserAccountClosed	Kimliği doğrulanmış kullanıcının YouTube hesabı kapalı. Kimliği doğrulanmış kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata, söz konusu Google Hesabı'nı ifade eder.
forbidden (403)	authenticatedUserAccountSuspended	Kimliği doğrulanmış kullanıcının YouTube hesabı askıya alındı. Kimliği doğrulanmış kullanıcı başka bir Google Hesabı adına işlem yapıyorsa bu hata, söz konusu hesabı ifade eder.
forbidden (403)	authenticatedUserNotChannel	Bu istek için kimliği doğrulanmış kullanıcının bir kanala çözümlenmesi gerekir ancak bu işlem gerçekleşmedi. İsteğiniz kimlik doğrulaması yapılmışsa ve onBehalfOfContentOwner yetki parametresini kullanıyorsa onBehalfOfContentOwnerChannel parametresini de ayarlamanız gerekir.
forbidden (403)	channelClosed	İstekte belirtilen kanal kapatıldı.
forbidden (403)	channelNotFound	İstekle tanımlanan kanal bulunamıyor.
forbidden (403)	channelSuspended	İstekte belirtilen kanal askıya alındı.
forbidden (403)	cmsUserAccountNotFound	İçerik yönetim sistemi kullanıcısının, belirtilen içerik sahibi adına işlem yapmasına izin verilmiyor.
forbidden (403)	insufficientCapabilities	İçerik Yönetim Sistemi kullanıcısının yeterli yetkisi yok.
forbidden (403)	insufficientPermissions	İstek için sağlanan OAuth 2.0 jetonu, istenen verilere erişmek için yetersiz olan kapsamları belirtiyor.
notFound (404)	contentOwnerAccountNotFound	Belirtilen içerik sahibi hesabı bulunamadı.

Request context errors

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	invalidLanguage	hl parametre değeri, geçerli bir dil kodu belirtmiyor.
badRequest (400)	invalidMine	İsteğin mine parametresini kullanması desteklenmiyor.
badRequest (400)	invalidMine	mine parametresi, kimliği doğrulanmış kullanıcının YouTube iş ortağı olduğu isteklerde kullanılamaz. mine parametresini kaldırmalı, onBehalfOfContentOwner parametresini kaldırarak YouTube kullanıcısı olarak kimliğinizi doğrulamalı veya çağrılan yöntem için kullanılabilirse onBehalfOfContentOwnerChannel parametresini sağlayarak iş ortağının kanallarından biri olarak hareket etmelisiniz.
badRequest (400)	invalidPart	İsteğin part parametresi, aynı anda yazılamayan bazı bölümleri belirtiyor.
badRequest (400)	invalidRegionCode	regionCode parametresi geçersiz bir bölge kodu belirtiyor.
badRequest (400)	unexpectedPart	İsteğin part parametresi beklenmeyen bir değer belirtiyor.
badRequest (400)	unknownPart	İsteğin part parametresi bilinmeyen bir değer belirtiyor.
badRequest (400)	unsupportedLanguageCode	hl parametre değeri, desteklenen bir dil kodu belirtmiyor.
badRequest (400)	unsupportedRegionCode	regionCode parametresi, desteklenmeyen bir bölge kodu belirtiyor.
unauthorized (401)	authorizationRequired	İstek, mine parametresini kullanıyor ancak uygun şekilde yetkilendirilmemiş.
unauthorized (401)	youtubeSignupRequired	Bu hata, kullanıcının bağlantısı kaldırılmış bir Google Hesabı olduğunu gösterir. Bu da kullanıcının Google Hesabı olduğu ancak YouTube kanalının olmadığı anlamına gelir. Bu kullanıcılar, kullanıcı yetkilendirmesine bağlı olan birçok özelliğe (ör. videolara puan verme veya videoları watch_later oynatma listesine ekleme) erişebilir. Ancak örneğin, kullanıcının video yükleyebilmesi için bir YouTube kanalına ihtiyacı vardır. Gmail hesabı veya Android cihazı olan bir kullanıcının Google Hesabı olduğu kesindir ancak bu Google Hesabı'nı YouTube kanalına bağlamamış olabilir. Bu hata genellikle OAuth 2.0 hizmet hesabı akışını kullanmaya çalıştığınızda görülür. YouTube, hizmet hesaplarını desteklemez. Hizmet hesabı kullanarak kimlik doğrulamaya çalışırsanız bu hatayı alırsınız. Google Hesabı desteğini tanıtan YouTube API blog yayınında youtubeSignupRequired hatası da daha ayrıntılı olarak ele alınmaktadır. Blog yayınında API'nin 2.1 sürümündeki hata açıklanmış olsa da hatanın anlamı geçerliliğini korumaktadır.

etkinlikler

Aşağıdaki tablolarda, API'nin activities kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

activities.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	homeParameterDeprecated	Kullanıcının ana sayfa etkinlik verileri bu API üzerinden kullanılamaz. Bu hata, yetkisiz bir istekte home parametresini true olarak ayarlarsanız oluşabilir.
forbidden (403)	forbidden	İstek düzgün şekilde yetkilendirilmemiş.
notFound (404)	channelNotFound	İsteğin channelId parametresiyle tanımlanan kanal kimliği bulunamıyor.
notFound (404)	homeChannelNotFound	Kimliği doğrulanmış mevcut kullanıcı için YouTube ana sayfası feed'i bulunamadı.
unauthorized (401)	authorizationRequired	İstek, home parametresini kullanıyor ancak uygun şekilde yetkilendirilmemiş.

altyazılar

Aşağıdaki tablolarda, API'nin captions kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

captions.delete

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı dosyasını silmek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	captionNotFound	Altyazı dosyası bulunamadı. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

captions.download

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı dosyasını indirmek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
invalidValue (400)	couldNotConvert	Altyazı dosyası verileri, istenen dile ve/veya biçime dönüştürülemedi. İstenen tfmt ve tlang değerlerinin geçerli olduğundan ve istenen altyazı dosyasının snippet.status değerinin failed olmadığından emin olun.
notFound (404)	captionNotFound	Altyazı dosyası bulunamadı. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

captions.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	contentRequired	İstek, altyazı dosyası içeriklerini barındırmıyor.
conflict (409)	captionExists	Belirtilen videoda, verilen snippet.language ve snippet.name ile altyazı dosyası zaten var. Bir videoda aynı dil için birden fazla parça olabilir ancak her parçanın farklı bir adı olmalıdır. Bu hatayı düzeltmenin birden fazla yolu vardır. Mevcut kanalı silip yeni bir kanal ekleyebilir veya yeni kanalı eklemeden önce adını değiştirebilirsiniz.
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı dosyasını yüklemek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
invalidValue (400)	invalidMetadata	İstek, parçanın oluşturulmasını engelleyen geçersiz meta veri değerleri içeriyor. İsteğin snippet.language, snippet.name ve snippet.videoId özellikleri için geçerli değerler belirttiğini onaylayın. snippet.isDraft özelliği de eklenebilir ancak zorunlu değildir.
notFound (404)	videoNotFound	videoId parametresiyle tanımlanan video bulunamadı.
invalidValue (400)	nameTooLong	İstekte belirtilen snippet.name çok uzun. En fazla 150 karakter desteklenmektedir.

captions.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	İstekle ilişkili izinler, istenen kaynakları almak için yeterli olmadığından bir veya daha fazla altyazı dosyası alınamadı. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	captionNotFound	Belirtilen altyazı dosyalarından biri veya daha fazlası bulunamadı. Bu hata, videoId parametresi gerçek bir videoyu tanımladığında ancak id parametresi ya mevcut olmayan altyazı dosyası kimliklerini ya da diğer videolarla ilişkili izleme kimliklerini tanımladığında oluşur. Doğru olduklarından emin olmak için isteğin id ve videoId parametrelerinin değerlerini kontrol edin.
notFound (404)	videoNotFound	videoId parametresiyle tanımlanan video bulunamadı.

captions.update

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	contentRequired	İstekle güncellenmiş bir altyazı dosyası yüklenmedi. sync parametresi true olarak ayarlanmışsa gerçek parça içerikleri gereklidir.
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı dosyasını güncellemek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	captionNotFound	Belirtilen altyazı dosyası bulunamadı. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

channelBanners

Aşağıdaki tablolarda, API'nin channelBanners kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

channelBanners.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	bannerAlbumFull	YouTube kanal resmi albümünüzde çok fazla resim var. Lütfen http://photos.google.com adresine gidip albümler sayfasına gidin ve ilgili albümden bazı resimleri kaldırın.
badRequest (400)	mediaBodyRequired	İstek, resim içeriğini içermiyor.

channelSections

Aşağıdaki tablolarda, API'nin channelSections kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

channelSections.delete

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	notEditable	Bu kanal bölümü silinemez.
forbidden (403)	channelSectionForbidden	İstek, bu kanal için düzgün şekilde doğrulanmamış veya desteklenmiyor.
invalidValue (400)	idInvalid	id özelliği, geçersiz bir kanal bölümü kimliği belirtiyor.
invalidValue (400)	idRequired	id özelliği, silinen kanal bölümünü tanımlayan bir değer belirtmelidir.
notFound (404)	channelNotFound	Kanal bulunamadı.
notFound (404)	channelSectionNotFound	Güncellemeye çalıştığınız kanal bölümü bulunamadı.

channelSections.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	defaultLanguageNotSetError	channelSection kaynağının snippet.defaultLanguage özelliği, ilgili kaynağın localizations nesnesini başarıyla ekleyecek veya güncelleyecek şekilde ayarlanmalıdır.
badRequest (400)	invalidLanguage	localizations nesnesinin dil anahtarlarından biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	notEditable	Bu kanal bölümü oluşturulamaz.
badRequest (400)	styleRequired	channelSection kaynağı, snippet.style alanı için bir değer belirtmelidir.
badRequest (400)	targetInvalidCountry	targeting.countries listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	targetInvalidLanguage	targeting.languages listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	targetInvalidRegion	targeting.regions listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	typeRequired	channelSection kaynağı, snippet.type alanı için bir değer belirtmelidir.
forbidden (403)	channelSectionForbidden	İstek, doğru şekilde doğrulanmamış veya bu kanal için desteklenmiyor.
invalidValue (400)	channelNotActive	Belirtilen kanallardan en az biri etkin değil.
invalidValue (400)	channelsDuplicated	İstek, yinelenen kanallar belirttiği için başarısız oldu.
invalidValue (400)	channelsNeeded	snippet.type özelliğinin değeri multipleChannels ise contentDetails.channels[] özelliği belirtilmeli ve en az bir kanal belirtilmelidir.
invalidValue (400)	channelsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.channels[] özelliği için bir değer belirtti ancak bu tür kanal bölümü için kanal beklenmiyor.
invalidValue (400)	contentDetailsNeeded	Eklediğiniz kaynak, bu tür kanal bölümleri için bir contentDetails nesnesi içermelidir.
invalidValue (400)	inValidPosition	snippet.position özelliği geçersiz bir değer içeriyor.
invalidValue (400)	maxChannelSectionExceeded	Kanalda zaten maksimum sayıda kanal bölümü bulunduğundan istek tamamlanamıyor.
invalidValue (400)	maxChannelsExceeded	İstek, kanal bölümüne çok fazla kanal eklemeye çalıştığı için başarısız oldu.
invalidValue (400)	maxPlaylistExceeded	İstek, kanal bölümüne çok fazla oynatma listesi eklemeye çalıştığı için başarısız oldu.
invalidValue (400)	onePlaylistNeeded	snippet.type özelliği singlePlaylist değerine sahipse contentDetails.playlists[] özelliği tam olarak bir oynatma listesi belirtmelidir.
invalidValue (400)	ownChannelInChannels	Kendi kanalınızı, söz konusu kanalda görünen bir kanal bölümüne ekleyemezsiniz.
invalidValue (400)	playlistIsPrivate	Belirtilen oynatma listelerinden biri veya daha fazlası gizli olduğundan kanal bölümüne eklenemez.
invalidValue (400)	playlistsDuplicated	İstek, yinelenen oynatma listeleri belirttiği için başarısız oldu.
invalidValue (400)	playlistsNeeded	snippet.type özelliğinin değeri singlePlaylist veya multiplePlaylists ise contentDetails.playlists[] özelliği belirtilmelidir.
invalidValue (400)	playlistsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.playlists[] özelliği için bir değer belirtti ancak bu tür kanal bölümleri için oynatma listeleri beklenmiyor.
invalidValue (400)	snippetNeeded	Kanal bölümünü oluşturmak için snippet belirtmeniz gerekir.
invalidValue (400)	titleLengthExceeded	snippet.title özelliğinin değeri çok uzun.
invalidValue (400)	titleRequired	snippet.type özelliği multiplePlaylists veya multipleChannels değerine sahipse snippet.title özelliği için bir değer belirterek bölümün başlığını ayarlamanız gerekir.
notFound (404)	channelNotFound	Belirtilen kanallardan biri veya daha fazlası bulunamıyor.
notFound (404)	playlistNotFound	Belirtilen oynatma listelerinden biri veya daha fazlası bulunamıyor.

channelSections.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	channelSectionForbidden	İstekte bulunan kullanıcının, istenen kanal bölümlerine erişmesine izin verilmiyor.
invalidValue (400)	idInvalid	İstek, geçersiz bir kanal bölümü kimliği belirtiyor.
invalidValue (400)	invalidCriteria	Filtre ölçütleri geçersiz olduğundan istek tamamlanamadı.
notFound (404)	channelNotFound	İstekle ilişkili kanal bulunamıyor.
notFound (404)	channelSectionNotFound	İstekle ilişkili kanal bölümü bulunamıyor.

channelSections.update

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	defaultLanguageNotSetError	channelSection kaynağının snippet.defaultLanguage özelliği, ilgili kaynağın localizations nesnesini başarıyla ekleyecek veya güncelleyecek şekilde ayarlanmalıdır.
badRequest (400)	invalidLanguage	localizations nesnesinin dil anahtarlarından biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	notEditable	Bu kanal bölümü düzenlenemez.
badRequest (400)	styleRequired	channelSection kaynağı, snippet.style alanı için bir değer belirtmelidir.
badRequest (400)	targetInvalidCountry	targeting.countries listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	targetInvalidLanguage	targeting.languages listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak belgelerindeki yönergeleri uygulayarak bunları güncellemek için channelSections.list yöntemini kullanın.
badRequest (400)	targetInvalidRegion	targeting.regions listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için channelSections.list yöntemini kullanın ve channelSections kaynak dokümanlarındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	typeRequired	channelSection kaynağı, snippet.type alanı için bir değer belirtmelidir.
forbidden (403)	channelSectionForbidden	İstek, doğru şekilde doğrulanmamış veya bu kanal için desteklenmiyor.
invalidValue (400)	channelNotActive	Belirtilen kanallardan en az biri etkin değil.
invalidValue (400)	channelsDuplicated	İstek, yinelenen kanallar belirttiği için başarısız oldu.
invalidValue (400)	channelsNeeded	snippet.type özelliğinin değeri multipleChannels ise contentDetails.channels[] özelliği belirtilmeli ve en az bir kanal belirtilmelidir.
invalidValue (400)	channelsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.channels[] özelliği için bir değer belirtti ancak bu tür kanal bölümü için kanal beklenmiyor.
invalidValue (400)	contentDetailsNeeded	Güncellediğiniz kaynak, bu tür kanal bölümleri için bir contentDetails nesnesi içermelidir.
invalidValue (400)	idInvalid	id özelliği, geçersiz bir kanal bölümü kimliği belirtiyor.
invalidValue (400)	idRequired	id özelliği, güncellenen kanal bölümünü tanımlayan bir değer belirtmelidir.
invalidValue (400)	inValidPosition	snippet.position özelliği geçersiz bir değer içeriyor.
invalidValue (400)	maxChannelsExceeded	İstek, kanal bölümüne çok fazla kanal eklemeye çalıştığı için başarısız oldu.
invalidValue (400)	maxPlaylistExceeded	İstek, kanal bölümüne çok fazla oynatma listesi eklemeye çalıştığı için başarısız oldu.
invalidValue (400)	onePlaylistNeeded	snippet.type özelliği singlePlaylist değerine sahipse contentDetails.playlists[] özelliği tam olarak bir oynatma listesi belirtmelidir.
invalidValue (400)	ownChannelInChannels	Kendi kanalınızı, söz konusu kanalda görünen bir kanal bölümüne ekleyemezsiniz.
invalidValue (400)	playlistIsPrivate	Belirtilen oynatma listelerinden biri veya daha fazlası gizli olduğundan kanal bölümüne eklenemez.
invalidValue (400)	playlistsDuplicated	İstek, yinelenen oynatma listeleri belirttiği için başarısız oldu.
invalidValue (400)	playlistsNeeded	snippet.type özelliğinin değeri singlePlaylist veya multiplePlaylists ise contentDetails.playlists[] özelliği belirtilmelidir.
invalidValue (400)	playlistsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.playlists[] özelliği için bir değer belirtti ancak bu tür kanal bölümleri için oynatma listeleri beklenmiyor.
invalidValue (400)	snippetNeeded	Kanal bölümünü güncellemek için snippet belirtmeniz gerekir.
invalidValue (400)	titleLengthExceeded	snippet.title özelliğinin değeri çok uzun.
invalidValue (400)	titleRequired	snippet.type özelliği multiplePlaylists veya multipleChannels değerine sahipse snippet.title özelliği için bir değer belirterek bölümün başlığını ayarlamanız gerekir.
notFound (404)	channelNotFound	Belirtilen kanallardan biri veya daha fazlası bulunamıyor.
notFound (404)	channelSectionNotFound	Güncellemeye çalıştığınız kanal bölümü bulunamadı.
notFound (404)	playlistNotFound	Belirtilen oynatma listelerinden biri veya daha fazlası bulunamıyor.

kanallar

Aşağıdaki tablolarda, API'nin channels kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

channels.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	invalidCriteria	Şu filtrelerden en fazla biri belirtilebilir:id, mySubscribers, categoryId, mine, managedByMe, forUsername. İçerik sahibi kimlik doğrulamasında onBehalfOfContentOwner parametresi kullanılıyorsa yalnızca id veya managedByMe belirtilebilir.
forbidden (403)	channelForbidden	id parametresiyle belirtilen kanal, isteği desteklemiyor veya istek düzgün şekilde yetkilendirilmemiş.
notFound (404)	categoryNotFound	categoryId parametresiyle tanımlanan kategori bulunamıyor.
notFound (404)	channelNotFound	id parametresinde belirtilen kanal bulunamıyor.

channels.update

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	brandingValidationError	brandingSettings nesnesindeki değerlerden biri doğrulanamadı. Kanalın mevcut ayarlarını almak için channels.list yöntemini kullanın ve channels kaynak dokümanlarındaki yönergeleri uygulayarak özellik değerlerini güncelleyin.
badRequest (400)	channelTitleUpdateForbidden	Bir kanalın brandingSettings part özelliğini güncellerken brandingSettings.channel.title özelliğinin değerini kanalın mevcut başlığına ayarlamanız veya özelliği atlamanız gerekir. Özelliğin değerini değiştirirseniz API bir hata döndürür.
badRequest (400)	defaultLanguageNotSetError	defaultLanguage, localizations değerini güncelleyecek şekilde ayarlanmalıdır.
badRequest (400)	invalidBrandingOption	Belirttiğiniz marka bilinci oluşturma ayarlarından biri mevcut değil. Geçerli değerleri almak için channels.list yöntemini kullanın ve channels kaynak dokümanlarındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	invalidCustomMessage	İstek meta verileri geçersiz bir özel mesaj belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.items[].customMessage özelliğinin değerini kontrol edin.
badRequest (400)	invalidDuration	İstek meta verileri, invideoPromotion bölümünde geçersiz bir süre belirtiyor.
badRequest (400)	invalidDuration	İstek meta verileri, tanıtılan öğenin video oynatıcıda nasıl konumlandırılacağını belirlemek için geçersiz bir konum türü belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.position.type özelliğinin değerini kontrol edin.
badRequest (400)	invalidRecentlyUploadedBy	İstek meta verileri geçersiz bir kanal kimliği belirtiyor. İsteğin gönderildiği kaynaktaki invideoPromotion.items[].id.recentlyUploadedBy özelliğinin değerini kontrol edin.
badRequest (400)	invalidTimingOffset	İstek meta verileri, invideoPromotion bölümünde geçersiz bir zaman farkı belirtiyor.
badRequest (400)	invalidTimingOffset	İstek meta verileri, tanıtılan öğenin video oynatıcıda ne zaman gösterileceğini belirlemek için geçersiz bir zaman farkı belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.timing.offsetMs özelliğinin değerini kontrol edin.
badRequest (400)	invalidTimingType	İstek meta verileri, tanıtılan öğenin video oynatıcıda ne zaman gösterileceğini belirlemek için geçersiz bir zamanlama yöntemi belirtiyor. İsteğin gönderildiği kaynaktaki invideoPromotion.timing.type özelliğinin değerini kontrol edin.
badRequest (400)	localizationValidationError	Yerelleştirme nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için channels.list yöntemini kullanın ve kanallar kaynağı dokümanlarındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	tooManyPromotedItems	invideoPromotion bölümünde izin verilen tanıtılan öğe sayısı aşıldı.
forbidden (403)	channelForbidden	id parametresinde belirtilen kanal, isteği desteklemiyor veya istek düzgün şekilde yetkilendirilmemiş.
forbidden (403)	promotedVideoNotAllowed	API isteğinin güncellemeye çalıştığı kanal bulunamadı. Kanal kimliğinin doğru olduğundan emin olmak için isteğin gönderildiği channel kaynağındaki id özelliğinin değerini kontrol edin.
forbidden (403)	websiteLinkNotAllowed	Belirtilen web sitesi URL'sine izin verilmiyor.
notFound (404)	channelNotFound	id parametresiyle belirtilen kanal bulunamıyor veya markalama seçenekleri yok.
notFound (404)	channelNotFound	id parametresinde belirtilen kanal bulunamıyor.
notFound (404)	unknownChannelId	Belirtilen kanal kimliği bulunamadı.
notFound (404)	unknownChannelId	Belirtilen recentlyUploadedBy kanal kimliği bulunamadı.
notFound (404)	unknownVideoId	Tanıtılan öğe olarak belirtilen video kimliği bulunamıyor.
required (400)	requiredItemIdType	İstek meta verileri, invideoPromotion bölümünde bir öğe türü belirtmelidir.
required (400)	requiredItemId	İstek meta verilerinde, invideoPromotion bölümünde bir öğe belirtilmelidir.
required (400)	requiredTimingOffset	YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için istek meta verilerinde varsayılan bir zaman farkı belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.offsetMs özelliğinin değerini ayarlayın.
required (400)	requiredTimingOffset	YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde bir zamanlama farkı belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.timing.offsetMs özelliğinin değerini ayarlayın.
required (400)	requiredTimingType	YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde bir zamanlama yöntemi belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.type özelliğinin değerini ayarlayın.
required (400)	requiredTimingType	YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde bir zamanlama yöntemi belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.timing.type özelliğinin değerini ayarlayın.
required (400)	requiredTiming	İstek meta verileri, invideoPromotion bölümündeki her öğe için bir zamanlama belirtmelidir.
required (400)	requiredVideoId	İstek meta verileri, tanıtılan öğeyi tanımlamak için bir video kimliği belirtmelidir.
required (400)	requiredWebsiteUrl	İstek meta verilerinde, invideoPromotion bölümünde bir web sitesi URL'si belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.items[].id.websiteUrl özelliğinin değerini ayarlayın.

commentThreads

Aşağıdaki tablolarda, API'nin commentThreads kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

commentThreads.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	operationNotSupported	API isteği geçersiz veya yanlış biçimlendirilmiş. Bu nedenle API sunucusu isteği anlayamadı.
badRequest (400)	processingFailure	API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. İstek gövdesindeki commentThread kaynağının yapısını kontrol ederek geçerli olduğundan emin olun.
forbidden (403)	commentsDisabled	videoId parametresiyle tanımlanan videoda yorumlar devre dışı bırakılmış.
forbidden (403)	forbidden	İstenen yorum dizilerinden biri veya daha fazlası, yetersiz izinler nedeniyle alınamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	channelNotFound	allThreadsRelatedToChannelId parametresiyle tanımlanan kanal bulunamadı.
notFound (404)	commentThreadNotFound	Belirtilen yorum dizilerinden biri veya daha fazlası bulunamıyor. Doğru olduğundan emin olmak için isteğin id parametresinin değerlerini kontrol edin.
notFound (404)	videoNotFound	videoId parametresiyle tanımlanan video bulunamadı.

commentThreads.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	channelOrVideoIdMissing	Her yorum dizisi bir kanala veya videoya bağlı olmalıdır. Kaynağın hem snippet.channelId hem de snippet.videoId özellikleri için değerler belirttiğinden emin olun. Videoya yapılan yorumlar, video izleme sayfasında gösterilir.
badRequest (400)	commentTextRequired	Eklenen comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş bırakılamaz.
badRequest (400)	commentTextTooLong	Eklenen comment kaynağının snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter var.
badRequest (400)	invalidCommentThreadMetadata	İstek meta verileri geçersiz.
badRequest (400)	processingFailure	API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. Geçerli olduğundan emin olmak için istek gövdesindeki commentThread kaynağının yapısını kontrol edin.
forbidden (403)	forbidden	Yorum dizisi, yetersiz izinler nedeniyle oluşturulamadı. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	ineligibleAccount	API isteğini yetkilendirmek için kullanılan YouTube hesabının, yorum veya yorum dizisi eklemek için kullanıcının Google Hesabı ile birleştirilmesi gerekir.
notFound (404)	channelNotFound	Belirtilen kanal bulunamadı. Doğru olduğundan emin olmak için snippet.channelId özelliğinin değerini kontrol edin.
notFound (404)	videoNotFound	Belirtilen video bulunamadı. Doğru olduğundan emin olmak için snippet.videoId özelliğinin değerini kontrol edin.

yorumlar

Aşağıdaki tablolarda, API'nin comments kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

comments.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	operationNotSupported	API isteği geçersiz veya yanlış biçimlendirilmiş. Bu nedenle API sunucusu isteği anlayamadı.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle istenen yorumlardan biri veya daha fazlası alınamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	commentNotFound	Belirtilen yorumlardan biri veya daha fazlası bulunamıyor. İsteğin id ve parentId parametrelerinin değerlerini kontrol ederek doğru olduklarından emin olun.

comments.setModerationStatus

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	banWithoutReject	banAuthor parametresi yalnızca moderationStatus parametre değeri rejected ise kullanılabilir.
badRequest (400)	operationNotSupported	API isteği geçersiz veya yanlış biçimlendirilmiş. Bu nedenle API sunucusu isteği anlayamadı.
badRequest (400)	processingFailure	API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle bir veya daha fazla yorumun moderasyon durumu ayarlanamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	commentNotFound	İsteğin güncellemeye çalıştığı yorumlardan biri veya daha fazlası bulunamıyor. Doğru olduklarından emin olmak için isteğin id parametresinin değerlerini kontrol edin.

comments.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	commentTextRequired	Eklenen comment kaynağı, snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş bırakılamaz.
badRequest (400)	commentTextTooLong	Eklenen comment kaynağının snippet.textOriginal özelliğinde çok fazla karakter var.
badRequest (400)	invalidCommentMetadata	İstek meta verileri geçersiz.
badRequest (400)	operationNotSupported	API kullanıcısı, snippet.parentId mülkü tarafından tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemiyor. Bir commentThread kaynağında, snippet.canReply özelliği mevcut görüntüleyenin ileti dizisini yanıtlayıp yanıtlayamayacağını belirtir.
badRequest (400)	parentCommentIsPrivate	Belirtilen üst yorum gizli. API, özel yorumlara verilen yanıtları desteklemez.
badRequest (400)	parentIdMissing	Eklenen yorum, bir üst yoruma bağlı olmalıdır. Ancak API isteğinin gövdesindeki comment kaynağı, snippet.parentId özelliği için bir değer belirtmedi.
badRequest (400)	processingFailure	API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. İstek gövdesindeki comment kaynağının yapısını kontrol ederek geçerli olduğundan emin olun.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle yorum oluşturulamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	ineligibleAccount	API isteğini yetkilendirmek için kullanılan YouTube hesabının, yorum veya yorum dizisi eklemek için kullanıcının Google Hesabı ile birleştirilmesi gerekir.
notFound (404)	parentCommentNotFound	Belirtilen üst yorum bulunamadı. İstek gövdesindeki snippet.parentId özelliğinin değerini kontrol ederek doğru olduğundan emin olun.

comments.delete

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	processingFailure	API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle yorum silinemedi. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	commentNotFound	Belirtilen yorum bulunamadı. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

comments.update

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	commentTextTooLong	Güncellenen comment kaynağının snippet.textOriginal mülkünde çok fazla karakter var.
badRequest (400)	invalidCommentMetadata	İstek meta verileri geçersiz.
badRequest (400)	operationNotSupported	API isteği geçersiz veya yanlış biçimlendirilmiş. Bu nedenle API sunucusu isteği anlayamadı.
badRequest (400)	processingFailure	API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. İstek gövdesindeki comment kaynağının yapısını kontrol ederek geçerli olduğundan emin olun.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle yorum güncellenemedi. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	ineligibleAccount	API isteğini yetkilendirmek için kullanılan YouTube hesabının, bir yorumu veya yorum dizisini güncellemek için kullanıcının Google Hesabı ile birleştirilmesi gerekir.
notFound (404)	commentNotFound	Belirtilen yorum bulunamadı. İstek gövdesindeki id özelliğinin değerini kontrol ederek doğru olduğundan emin olun.

üyeler

Aşağıdaki tablolarda, API'nin members kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

members.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	channelMembershipsNotEnabled	İsteği yetkilendiren içerik üretici kanalında kanal üyelikleri etkinleştirilmemiş.
badRequest (400)	invalidMode	mode parametre değeri geçersiz. Bu hata, pageToken parametresi belirtilenden farklı bir mod kullanılarak alınan bir jetonu belirtiyorsa oluşabilir.
badRequest (400)	invalidPageToken	pageToken parametre değeri geçersiz. Bu hata, istekte kullanılan sayfa jetonunun süresi dolmuşsa oluşur.
badRequest (400)	invalidHasAccessToLevel	hasAccessToLevel parametre değeri geçersiz. Belirtilen id ile eşleşen bir seviye yok.
badRequest (400)	invalidFilterByMemberChannelId	filterByMemberChannelId parametre değeri geçersiz. Bu hata, filterByMemberChannelId parametre değeri 100'den fazla kanal belirtiyorsa ortaya çıkar.

membershipsLevels

Aşağıdaki tablolarda, API'nin members kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

membershipsLevels.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	channelMembershipsNotEnabled	İsteği yetkilendiren içerik üretici kanalında kanal üyelikleri etkinleştirilmemiş.

playlistItems

Aşağıdaki tablolarda, API'nin playlistItems kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

playlistItems.delete

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	playlistItemsNotAccessible	İstek, belirtilen oynatma listesi öğesini silmek için uygun şekilde yetkilendirilmemiş.
notFound (404)	playlistItemNotFound	İsteğin id parametresiyle tanımlanan oynatma listesi öğesi bulunamadı.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesinden videoların silinmesini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizden video silemezsiniz.

playlistItems.insert

Hata türü	Hata ayrıntısı	Açıklama
duplicate	videoAlreadyInPlaylist	Oynatma listesine eklemeye çalıştığınız video zaten oynatma listesinde.
forbidden (403)	playlistContainsMaximumNumberOfVideos	Oynatma listesi, izin verilen maksimum sayıda öğe içeriyor.
forbidden (403)	playlistItemsNotAccessible	İstek, belirtilen oynatma listesi öğesini eklemek için uygun şekilde yetkilendirilmemiş.
invalidValue (400)	invalidContentDetails	İstekteki contentDetails özelliği geçerli değil. Bunun olası bir nedeni, contentDetails.note alanının 280 karakterden uzun olmasıdır.
invalidValue (400)	invalidPlaylistItemPosition	İstek, oynatma listesi öğesinin konumunu geçersiz veya desteklenmeyen bir değere ayarlamaya çalışıyor. Kaynağın snippet bölümündeki position özelliğinin değerini kontrol edin.
invalidValue (400)	invalidResourceType	Kaynak kimliği için belirtilen type bu işlemde desteklenmiyor. Kaynak kimliği, oynatma listesine eklenen öğeyi (ör. youtube#video) tanımlar.
invalidValue (400)	manualSortRequired	İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışıyor ancak oynatma listesi manuel sıralama kullanmıyor. (Örneğin, oynatma listesi öğeleri tarihe veya popülerliğe göre sıralanabilir.) İsteğin eklediği kaynaktan snippet.position öğesini kaldırarak hatayı düzeltebilirsiniz. Oynatma listesi öğesinin listede belirli bir konuma sahip olmasını istiyorsanız öncelikle oynatma listesinin ayarlarında oynatma listesinin Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayar, YouTube Video Yöneticisi'nden düzenlenebilir.
invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Oynatma listesine eklemeye çalıştığınız video, başka bir dizi oynatma listesinde bulunuyor.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesine video ekleme özelliğini desteklemiyor. Örneğin, yüklenen videolar oynatma listenize video ekleyemezsiniz.
notFound (404)	playlistNotFound	İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamadı.
notFound (404)	videoNotFound	Oynatma listesine eklemeye çalıştığınız video bulunamadı. Doğru olduğundan emin olmak için videoId özelliğinin değerini kontrol edin.
required (400)	channelIdRequired	İstekte, gerekli channelId özelliği için bir değer belirtilmemiş.
required (400)	playlistIdRequired	İstek, gerekli playlistId özelliği için bir değer belirtmiyor.
required (400)	resourceIdRequired	İstek, snippet nesnesinin resourceId belirttiği bir kaynak içermelidir.

playlistItems.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	playlistItemsNotAccessible	İstenen oynatma listesini almak için istek düzgün şekilde yetkilendirilmedi.
notFound (404)	playlistNotFound	İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamıyor.
notFound (404)	videoNotFound	İsteğin videoId parametresiyle tanımlanan video bulunamıyor.
required (400)	playlistIdRequired	Abone olma isteği, gerekli playlistId özelliği için bir değer belirtmiyor.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesindeki videoları listeleme özelliğini desteklemiyor. Örneğin, bir videoyu daha sonra izle oynatma listenize ekleyemezsiniz.

playlistItems.update

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	playlistItemsNotAccessible	İstek, belirtilen oynatma listesi öğesini güncellemek için uygun şekilde yetkilendirilmemiş.
invalidValue (400)	invalidPlaylistItemPosition	İstek, oynatma listesi öğesinin konumunu geçersiz veya desteklenmeyen bir değere ayarlamaya çalışıyor. Kaynağın snippet bölümündeki position özelliğinin değerini kontrol edin.
invalidValue (400)	invalidResourceType	Kaynak kimliği için belirtilen type bu işlemde desteklenmiyor. Kaynak kimliği, oynatma listesine eklenen öğeyi (ör. youtube#video) tanımlar.
invalidValue (400)	invalidSnippet	İstekte geçerli bir snippet mülkü belirtilmiyor.
invalidValue (400)	manualSortRequired	İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışıyor ancak oynatma listesinde manuel sıralama kullanılmıyor. (Örneğin, oynatma listesi öğeleri tarihe veya popülerliğe göre sıralanabilir.) İsteğin eklediği kaynaktan snippet.position öğesini kaldırarak hatayı düzeltebilirsiniz. Oynatma listesi öğesinin listede belirli bir konuma sahip olmasını istiyorsanız öncelikle oynatma listesinin ayarlarında oynatma listesinin Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayar, YouTube Video Yöneticisi'nden düzenlenebilir.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesindeki videoları güncelleme özelliğini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizdeki bir videoyu güncelleyemezsiniz.
notFound (404)	playlistItemNotFound	İsteğin id özelliğiyle tanımlanan oynatma listesi öğesi bulunamadı.
notFound (404)	playlistNotFound	İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamadı.
required (400)	channelIdRequired	İstekte, gerekli channelId özelliği için bir değer belirtilmemiş.
required (400)	playlistIdRequired	İstek, gerekli playlistId özelliği için bir değer belirtmiyor.
required (400)	playlistItemIdRequired	İstekte belirtilen oynatma listesi öğesi kaynağı, güncellenen oynatma listesi öğesini tanımlamak için id özelliğini kullanmalıdır.

oynatma listeleri

Aşağıdaki tablolarda, API'nin playlists kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

playlists.delete

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	playlistForbidden	Bu işlem yasaktır veya istek düzgün şekilde yetkilendirilmemiştir.
notFound (404)	playlistNotFound	İsteğin id parametresiyle tanımlanan oynatma listesi bulunamadı.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesini silme özelliğini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizi silemezsiniz.

playlists.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	channelClosed	channelId parametresinde belirtilen kanal kapatıldı.
forbidden (403)	channelSuspended	channelId parametresinde belirtilen kanal askıya alındı.
forbidden (403)	playlistForbidden	İsteğin id parametresiyle tanımlanan oynatma listesi, isteği desteklemiyor veya istek düzgün şekilde yetkilendirilmemiş.
notFound (404)	channelNotFound	channelId parametresinde belirtilen kanal bulunamıyor.
notFound (404)	playlistNotFound	İsteğin id parametresiyle tanımlanan oynatma listesi bulunamadı.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesini listeleme özelliğini desteklemiyor. Örneğin, "Daha sonra izle" oynatma listenizi listeleyemezsiniz.

playlists.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	defaultLanguageNotSetError	defaultLanguage, localizations değerini güncelleyecek şekilde ayarlanmalıdır.
badRequest (400)	localizationValidationError	Yerelleştirme nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için playlists.list yöntemini kullanın ve oynatma listeleri kaynak belgelerindeki yönergeleri uygulayarak değerleri güncelleyin.
badRequest (400)	maxPlaylistExceeded	Kanalda izin verilen maksimum sayıda oynatma listesi bulunduğundan oynatma listesi oluşturulamıyor.
forbidden (403)	playlistForbidden	Bu işlem yasaktır veya istek düzgün şekilde yetkilendirilmemiştir.
invalidValue (400)	invalidPlaylistSnippet	İstek, geçersiz bir oynatma listesi snippet'i sağlıyor.
required (400)	playlistTitleRequired	İstekte bir oynatma listesi başlığı belirtilmelidir.

playlists.update

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	defaultLanguageNotSetError	defaultLanguage, localizations değerini güncelleyecek şekilde ayarlanmalıdır.
badRequest (400)	localizationValidationError	Yerelleştirme nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için playlists.list yöntemini kullanın ve oynatma listeleri kaynak belgelerindeki yönergeleri uygulayarak değerleri güncelleyin.
forbidden (403)	playlistForbidden	Bu işlem yasak veya istek düzgün şekilde yetkilendirilmemiş.
invalidValue (400)	invalidPlaylistSnippet	İstek, geçersiz bir oynatma listesi snippet'i sağlıyor.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesini güncelleme özelliğini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizin özelliklerini güncelleyemezsiniz.
notFound (404)	playlistNotFound	İsteğin id parametresiyle tanımlanan oynatma listesi bulunamadı.
required (400)	playlistTitleRequired	İstek, oynatma listesi başlığı belirtmelidir.

ara

Aşağıdaki tablolarda, API'nin search kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

search.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	invalidChannelId	channelId parametresi geçersiz bir kanal kimliği belirtti.
badRequest (400)	invalidLocation	location ve/veya locationRadius parametre değeri yanlış biçimlendirilmiş.
badRequest (400)	invalidRelevanceLanguage	relevanceLanguage parametre değeri yanlış biçimlendirilmiş.
badRequest (400)	invalidSearchFilter	İstek, geçersiz bir arama filtresi ve/veya kısıtlama kombinasyonu içeriyor. eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated veya videoType parametreleri için bir değer ayarlarsanız type parametresini video olarak ayarlamanız gerekir.

abonelikler

Aşağıdaki tablolarda, API'nin subscriptions kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

subscriptions.delete

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	subscriptionForbidden	İstek, bu kanal için doğru şekilde doğrulanmamış veya desteklenmiyor.
notFound (404)	subscriptionNotFound	Silmeye çalıştığınız abonelik bulunamadı. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

subscriptions.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	subscriptionDuplicate	Oluşturmaya çalıştığınız abonelik zaten mevcut.
badRequest (400)	subscriptionForbidden	Maksimum abonelik sayısına ulaştınız.
badRequest (400)	subscriptionForbidden	Yakın zamanda çok fazla kullanıcı bu kanala abone oldu. Lütfen birkaç saat içinde tekrar deneyin.
badRequest (400)	subscriptionForbidden	Kendi kanalınıza abone olamazsınız.
forbidden (403)	subscriptionForbidden	İstek, bu kanal için düzgün şekilde doğrulanmamış veya desteklenmiyor.
notFound (404)	publisherNotFound	İsteğin snippet.resourceId mülkü tarafından belirtilen kaynak bulunamıyor.
notFound (404)	subscriberNotFound	İstekle tanımlanan abone bulunamıyor.
required (400)	publisherRequired	İstekle belirtilen abonelik kaynağı, abone olunan kanalı tanımlamak için snippet.resourceId özelliğini kullanmalıdır.

subscriptions.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	accountClosed	Abone hesabı kapalı olduğundan abonelikler alınamadı.
forbidden (403)	accountSuspended	Abone hesabı askıya alındığı için abonelikler alınamadı.
forbidden (403)	subscriptionForbidden	İstekte bulunan kullanıcının, istenen aboneliklere erişim izni yok.
notFound (404)	subscriberNotFound	İstekle tanımlanan abone bulunamıyor.

küçük resimler

Aşağıdaki tablolarda, API'nin thumbnails kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

thumbnails.set

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	invalidImage	Sağlanan resim içeriği geçersiz.
badRequest (400)	mediaBodyRequired	İstek, resim içeriğini içermiyor.
forbidden (403)	forbidden	Belirtilen video için küçük resim ayarlanamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	forbidden	Kimliği doğrulanan kullanıcının özel video küçük resimleri yükleme ve ayarlama izni yok.
notFound (404)	videoNotFound	Küçük resim eklemeye çalıştığınız video bulunamıyor. İsteğin videoId parametresinin değerini kontrol ederek doğru olduğundan emin olun.
tooManyRequests (429)	uploadRateLimitExceeded	Kanala son zamanlarda çok fazla küçük resim yüklendi. Lütfen isteği daha sonra tekrar deneyin.

videoAbuseReportReasons

Aşağıdaki tablolarda, API'nin videoAbuseReportReasons kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

videoAbuseReportReasons.list

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	Erişim yasak. İstek düzgün şekilde yetkilendirilmemiş olabilir.

videoCategories

Aşağıdaki tablolarda, API'nin videoCategories kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

videoCategories.list

Hata türü	Hata ayrıntısı	Açıklama
notFound (404)	videoCategoryNotFound	id parametresiyle tanımlanan video kategorisi bulunamıyor. Geçerli değerlerin listesini almak için videoCategories.list yöntemini kullanın.

videolar

Aşağıdaki tablolarda, API'nin videos kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

videos.insert

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	defaultLanguageNotSet	İstek, video ayrıntılarının varsayılan dilini belirtmeden yerelleştirilmiş video ayrıntıları eklemeye çalışıyor.
badRequest (400)	invalidCategoryId	snippet.categoryId özelliği, geçersiz bir kategori kimliği belirtiyor. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
badRequest (400)	invalidDescription	İstek meta verileri geçersiz bir video açıklaması belirtiyor.
badRequest (400)	invalidFilename	Slug başlığında belirtilen video dosya adı geçersiz.
badRequest (400)	invalidPublishAt	İstek meta verileri, geçersiz bir planlanmış yayınlama zamanı belirtiyor.
badRequest (400)	invalidRecordingDetails	İstek meta verilerindeki recordingDetails nesnesi, geçersiz kayıt ayrıntıları belirtiyor.
badRequest (400)	invalidTags	İstek meta verileri geçersiz video anahtar kelimeleri belirtiyor.
badRequest (400)	invalidTitle	İstek meta verilerinde geçersiz veya boş bir video başlığı belirtiliyor.
badRequest (400)	invalidVideoGameRating	İstek meta verileri geçersiz bir video oyunu derecelendirmesi belirtiyor.
badRequest (400)	invalidVideoMetadata	İstek meta verileri geçersiz. Bu hata, istek bir video kaynağının snippet bölümünü güncelliyor ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamıyorsa ortaya çıkar.
badRequest (400)	mediaBodyRequired	İstek, video içeriğini içermiyor.
badRequest (400)	uploadLimitExceeded	Kanalın günlük video yükleme sınırına ulaşıldı. Bu, YouTube platformu kısıtlamasıdır ve Google Cloud projenizin API kotasından tamamen ayrıdır.
forbidden (403)	forbidden
forbidden (403)	forbiddenLicenseSetting	İstek, video için geçersiz bir lisans ayarlamaya çalışıyor.
forbidden (403)	forbiddenPrivacySetting	İstek, video için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.

videos.list

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	videoChartNotFound	İstenen video grafiği desteklenmiyor veya kullanılamıyor.
forbidden (403)	forbidden	İsteğin, video dosyasına veya işleme bilgilerine erişmek için uygun yetkisi yok. fileDetails, processingDetails ve suggestions bölümleri yalnızca videonun sahibi tarafından kullanılabilir.
forbidden (403)	forbidden	İstek, kullanıcı puanı bilgilerine erişemiyor. Bu hata, isteğin myRating parametresini kullanmak için düzgün şekilde yetkilendirilmemesinden kaynaklanabilir.
notFound (404)	videoNotFound	Almaya çalıştığınız video bulunamıyor. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

videos.delete

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	Silmeye çalıştığınız video silinemiyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	videoNotFound	Silmeye çalıştığınız video bulunamıyor. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

videos.update

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	defaultLanguageNotSet	API isteği, video ayrıntılarının varsayılan dilini belirtmeden yerelleştirilmiş video ayrıntıları eklemeye çalışıyor.
badRequest (400)	invalidCategoryId	snippet.categoryId özelliği, geçersiz bir kategori kimliği belirtiyor. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
badRequest (400)	invalidDefaultBroadcastPrivacySetting	İstek, varsayılan yayın için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.
badRequest (400)	invalidDescription	İstek meta verileri geçersiz bir video açıklaması belirtiyor.
badRequest (400)	invalidPublishAt	İstek meta verilerinde geçersiz bir planlanmış yayınlanma zamanı belirtiliyor.
badRequest (400)	invalidRecordingDetails	İstek meta verilerindeki recordingDetails nesnesi, geçersiz kayıt ayrıntıları belirtiyor.
badRequest (400)	invalidTags	İstek meta verileri geçersiz video anahtar kelimeleri belirtiyor.
badRequest (400)	invalidTitle	İstek meta verileri, geçersiz veya boş bir video başlığı belirtiyor.
badRequest (400)	invalidVideoMetadata	İstek meta verileri geçersiz. Bu hata, istek bir video kaynağının snippet bölümünü güncellediğinde ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamadığında oluşur.
forbidden (403)	forbidden	Erişim yasak. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	forbiddenEmbedSetting	İstek, video için geçersiz bir yerleştirme ayarı belirlemeye çalışıyor. Bazı kanalların canlı yayınlar için yerleştirilmiş oynatıcı sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atabilirsiniz.
forbidden (403)	forbiddenLicenseSetting	İstek, video için geçersiz bir lisans ayarlamaya çalışıyor.
forbidden (403)	forbiddenPrivacySetting	İstek, video için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.
notFound (404)	videoNotFound	Güncellemeye çalıştığınız video bulunamıyor. İstek gövdesindeki id alanının değerinin doğru olduğundan emin olun.

videos.rate

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	emailNotVerified	Kullanıcı, puan vermeden önce e-posta adresini doğrulamalıdır.
badRequest (400)	invalidRating	İstek, rating parametresi için beklenmeyen bir değer içeriyordu.
badRequest (400)	videoPurchaseRequired	Kiralık videolar yalnızca kiralayan kullanıcılar tarafından derecelendirilebilir.
forbidden (403)	forbidden	Puan vermeye çalıştığınız video puanlanamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	videoRatingDisabled	Puan vermeye çalıştığınız videonun sahibi, bu videonun puanlarını devre dışı bırakmış olabilir.
notFound (404)	videoNotFound	Puan vermeye çalıştığınız video bulunamadı. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

videos.reportAbuse

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	invalidAbuseReason	İstek, reason_id alanı veya reason_id ve secondary_reason_id alanlarının bir kombinasyonu için beklenmeyen bir değer içeriyordu.
badRequest (400)	rateLimitExceeded	Kullanıcı, belirli bir zaman aralığında çok fazla istek gönderdi.
forbidden (403)	forbidden
notFound (404)	videoNotFound	Kötüye kullanım bildiriminde bulunmaya çalıştığınız video bulunamıyor.

filigranlar

Aşağıdaki tablolarda, API'nin watermarks kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları belirtilmektedir. Bu yöntemler, Sık karşılaşılan istek hataları bölümünde listelenen hataları da döndürebilir.

watermarks.set

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

watermarks.unset

Hata türü	Hata ayrıntısı	Açıklama
forbidden (403)	forbidden	Belirtilen kanal için filigran kaldırılamaz. İstek düzgün şekilde yetkilendirilmemiş olabilir veya channelId parametresi geçersiz bir değere ayarlanmış olabilir.