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öntemle ilgili hata listesini bu 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ıları	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ıları	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	İstek, gerekli bir parametreyi içermiyor.
badRequest (400)	unexpectedParameter	İstek, beklenmeyen bir parametre belirtiyor.
forbidden (403)	accountDelegationForbidden	Kimliği doğrulanmış kullanıcı, belirtilen Google Hesabı adına işlem yapamıyor.
forbidden (403)	authenticatedUserAccountClosed	Kimliği doğrulanmış kullanıcının YouTube hesabı kapatıldı. Kimliği doğrulanmış kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata, söz konusu Google Hesabı ile ilgilidir.
forbidden (403)	authenticatedUserAccountSuspended	Kimliği doğrulanmış kullanıcının YouTube hesabı askıya alınmışsa Kimliği doğrulanmış kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata, söz konusu Google Hesabı ile ilgilidir.
forbidden (403)	authenticatedUserNotChannel	Bu istek için kimliği doğrulanmış kullanıcının bir kanala yönlendirilmesi gerekir ancak yönlendirilmiyor. İsteğinizin kimliği doğrulanmışsa ve onBehalfOfContentOwner yetkilendirme parametresini kullanıyorsa onBehalfOfContentOwnerChannel parametresini de ayarlamanız gerekir.
forbidden (403)	channelClosed	İstekle tanımlanan kanal kapatıldı.
forbidden (403)	channelNotFound	İstekte belirtilen kanal bulunamıyor.
forbidden (403)	channelSuspended	İstekte belirtilen kanal askıya alınmış.
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 yetkileri yok.
forbidden (403)	insufficientPermissions	İstek için sağlanan OAuth 2.0 jetonu, istenen verilere erişmek için yetersiz kapsamlar belirtiyor.
notFound (404)	contentOwnerAccountNotFound	Belirtilen içerik sahibi hesabı bulunamadı.

Request context errors

Hata türü	Hata ayrıntıları	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	Kimliği doğrulanmış kullanıcının YouTube iş ortağı olduğu isteklerde mine parametresi kullanılamaz. mine parametresini kaldırmanız, onBehalfOfContentOwner parametresini kaldırarak YouTube kullanıcısı olarak kimliğinizi doğrulamanız veya çağrılan yöntem için kullanılabilirse onBehalfOfContentOwnerChannel parametresini sağlayarak iş ortağının kanallarından biri olarak hareket etmeniz gerekir.
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 kodunu 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 durumda kullanıcının Google Hesabı vardır ancak YouTube kanalı yoktur. Bu kullanıcılar, video derecelendirme veya videoyu watch_later oynatma listesine ekleme gibi kullanıcı yetkilendirmesine bağlı birçok özelliğe erişebilir. Ancak örnek olarak, kullanıcının video yükleyebilmesi için YouTube kanalının olması gerekir. Gmail hesabı veya Android cihazı olan bir kullanıcının Google Hesabı olduğu kesindir ancak bu Google Hesabı'nı bir 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 sürümü 2.1'deki 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ı tanımlanmaktadır. 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ıları	Açıklama
forbidden (403)	homeParameterDeprecated	Kullanıcının ana sayfa etkinlik verileri bu API üzerinden kullanılamaz. Yetkisiz bir istekte home parametresini true olarak ayarlarsanız bu hata oluşabilir.
forbidden (403)	forbidden	İstek düzgün şekilde yetkilendirilmedi.
notFound (404)	channelNotFound	İsteğin channelId parametresiyle tanımlanan kanal kimliği bulunamıyor.
notFound (404)	homeChannelNotFound	Şu anda kimliği doğrulanmış kullanıcı için bir YouTube ana sayfası feed'i bulunamıyor.
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ıları	Açıklama
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı parçasını silmek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	captionNotFound	Altyazı dosyası bulunamadı. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

captions.download

Hata türü	Hata ayrıntıları	Açıklama
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı parçasını indirmek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
invalidValue (400)	couldNotConvert	Altyazı parçası 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ı parçasının snippet.status değerinin failed olmadığından emin olun.
notFound (404)	captionNotFound	Altyazı dosyası bulunamadı. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

captions.insert

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	contentRequired	İstek, altyazı parçası içeriklerini içermiyor.
conflict (409)	captionExists	Belirtilen videoda, verilen snippet.language ve snippet.name ile altyazı parçası 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 parçayı silebilir ve ardından yeni bir parça ekleyebilir veya eklemeden önce yeni parçanın adını değiştirebilirsiniz.
forbidden (403)	forbidden	İstekle ilişkili izinler, altyazı parçası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ğinden emin olun. 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ıları	Açıklama
forbidden (403)	forbidden	İstekle ilişkili izinler, istenen kaynakları almak için yeterli olmadığından bir veya daha fazla altyazı parçası alınamadı. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	captionNotFound	Belirtilen altyazı parçalarından biri veya daha fazlası bulunamadı. Bu hata, videoId parametresi gerçek bir videoyu tanımlarsa ancak id parametresi mevcut olmayan altyazı parçası kimliklerini veya diğer videolarla ilişkili parça kimliklerini tanımlarsa oluşur. İsteğin id ve videoId parametrelerinin değerlerini kontrol ederek doğru olduklarından emin olun.
notFound (404)	videoNotFound	videoId parametresiyle tanımlanan video bulunamadı.

captions.update

Hata türü	Hata ayrıntıları	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ı parçasını güncellemek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	captionNotFound	Belirtilen altyazı dosyası bulunamadı. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

channelBanners

Aşağıdaki tablolarda, API'nin channelBanners 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.

channelBanners.insert

Hata türü	Hata ayrıntıları	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 yönlenin ve 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ıları	Açıklama
badRequest (400)	notEditable	Bu kanal bölümü silinemez.
forbidden (403)	channelSectionForbidden	İstek düzgün şekilde kimliği doğrulanmamış veya bu kanal için 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ü bulunamıyor.

channelSections.insert

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	defaultLanguageNotSetError	channelSection kaynağının snippet.defaultLanguage özelliği, söz konusu kaynağın localizations nesnesini başarıyla eklemek veya güncellemek için ayarlanmalıdır.
badRequest (400)	invalidLanguage	localizations nesnesinin dil anahtarlarından biri doğrulanamadı. Geçerli değerleri almak için channelSections.list yöntemini kullanın ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
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 için channelSections.list yöntemini kullanın ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	targetInvalidLanguage	targeting.languages listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için channelSections.list yöntemini kullanın ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanı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 düzgün şekilde kimliği 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ğinden başarısız oldu.
invalidValue (400)	channelsNeeded	snippet.type özelliği multipleChannels değerine sahipse contentDetails.channels[] özelliği belirtilmeli ve en az bir kanal belirtmelidir.
invalidValue (400)	channelsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.channels[] özelliği için bir değer belirtmiş ancak bu tür kanal bölümü için kanallar 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	Kanal bölümüne çok fazla kanal eklenmeye çalışıldığından istek 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ğu için 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ği singlePlaylist veya multiplePlaylists değerine sahipse contentDetails.playlists[] özelliği belirtilmelidir.
invalidValue (400)	playlistsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.playlists[] özelliği için bir değer belirtmiş ancak bu tür kanal bölümleri için oynatma listeleri beklenmiyor.
invalidValue (400)	snippetNeeded	Kanal bölümü oluşturmak için bir 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ı bulunamadı.

channelSections.list

Hata türü	Hata ayrıntıları	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ü bulunamadı.

channelSections.update

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	defaultLanguageNotSetError	channelSection kaynağının snippet.defaultLanguage özelliği, söz konusu kaynağın localizations nesnesini başarıyla eklemek veya güncellemek için ayarlanmalıdır.
badRequest (400)	invalidLanguage	localizations nesnesinin dil anahtarlarından biri doğrulanamadı. Geçerli değerleri almak için channelSections.list yöntemini kullanın ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
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 için channelSections.list yöntemini kullanın ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	targetInvalidLanguage	targeting.languages listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için channelSections.list yöntemini kullanın ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanı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 düzgün şekilde kimliği 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ğinden başarısız oldu.
invalidValue (400)	channelsNeeded	snippet.type özelliği multipleChannels değerine sahipse contentDetails.channels[] özelliği belirtilmeli ve en az bir kanal belirtmelidir.
invalidValue (400)	channelsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.channels[] özelliği için bir değer belirtmiş ancak bu tür kanal bölümü için kanallar 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	Kanal bölümüne çok fazla kanal eklenmeye çalışıldığından istek 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ğu için 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ği singlePlaylist veya multiplePlaylists değerine sahipse contentDetails.playlists[] özelliği belirtilmelidir.
invalidValue (400)	playlistsNotExpected	İstekle birlikte sağlanan kaynak, contentDetails.playlists[] özelliği için bir değer belirtmiş 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ü bulunamıyor.
notFound (404)	playlistNotFound	Belirtilen oynatma listelerinden biri veya daha fazlası bulunamadı.

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ıları	Açıklama
badRequest (400)	invalidCriteria	Şu filtrelerden en fazla biri belirtilebilir:id, mySubscribers, categoryId, mine, managedByMe, forUsername. onBehalfOfContentOwner parametresi kullanılarak içerik sahibi kimlik doğrulaması yapılması durumunda 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ıları	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. Mülkün değerini değiştirirseniz API hata döndürür.
badRequest (400)	defaultLanguageNotSetError	defaultLanguage, localizations olarak güncellenmelidir.
badRequest (400)	invalidBrandingOption	Belirttiğiniz markalama ayarlarından biri mevcut değil. Geçerli değerleri almak için channels.list yöntemini kullanın ve channels kaynak dokümanı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 kaynaktaki 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 kaynaktaki invideoPromotion.position.type özelliğinin değerini kontrol edin.
badRequest (400)	invalidRecentlyUploadedBy	İstek meta verilerinde geçersiz bir kanal kimliği belirtiliyor. İ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 zamanlama 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 zamanlama ofseti belirtiyor. İsteğin gönderildiği kaynaktaki 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 channels kaynak dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	tooManyPromotedItems	Video içi tanıtım 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 bulunamıyor. 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 verilerinde, invideoPromotion bölümünde bir öğe türü belirtilmelidir.
required (400)	requiredItemId	İstek meta verilerinde invideoPromotion bölümünde bir öğe belirtilmelidir.
required (400)	requiredTimingOffset	YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde varsayılan bir zamanlama 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ı belirtilmesi gerekir. İ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ıları	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. Geçerli olduğundan emin olmak için istek gövdesindeki commentThread kaynağının yapısını kontrol edin.
forbidden (403)	commentsDisabled	videoId parametresiyle tanımlanan videoda yorumlar devre dışı bırakılmıştır.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle istenen yorum dizilerinden biri veya daha fazlası alınamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404)	channelNotFound	allThreadsRelatedToChannelId parametresiyle tanımlanan kanal bulunamadı.
notFound (404)	commentThreadNotFound	Belirtilen yorum ileti 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ıları	Açıklama
badRequest (400)	channelOrVideoIdMissing	Her yorum dizisi bir kanala veya videoya bağlanmalıdır. Kaynağın hem snippet.channelId hem de snippet.videoId özellikleri için değer belirttiğinden emin olun. Bir videoya yapılan yorum, videonun izleme sayfasında görünür.
badRequest (400)	commentTextRequired	Eklenen comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş olamaz.
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	Yetersiz izinler nedeniyle yorum dizisi oluşturulamadı. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403)	ineligibleAccount	API isteğini yetkilendirmek için kullanılan YouTube hesabı, yorum veya yorum dizisi eklemek üzere kullanıcının Google Hesabı ile birleştirilmelidir.
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ı tanımlanmaktadır. 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ıları	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ıları	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. İsteğin id parametresinin değerlerinin doğru olduğundan emin olun.

comments.insert

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	commentTextRequired	Eklenen comment kaynağı, snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş olamaz.
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 özelliğiyle tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemiyor. Bir commentThread kaynağında, snippet.canReply özelliği mevcut izleyicinin ileti dizisine yanıt verip veremeyeceğini belirtir.
badRequest (400)	parentCommentIsPrivate	Belirtilen üst yorum gizlidir. API, özel yorumlara verilen yanıtları desteklemez.
badRequest (400)	parentIdMissing	Eklenen yorum, bir üst yoruma bağlanmalı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. Geçerli olduğundan emin olmak için istek gövdesindeki comment kaynağının yapısını kontrol edin.
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ı, yorum veya yorum dizisi eklemek üzere kullanıcının Google Hesabı ile birleştirilmelidir.
notFound (404)	parentCommentNotFound	Belirtilen üst yorum bulunamadı. Doğruluğundan emin olmak için istek gövdesindeki snippet.parentId özelliğinin değerini kontrol edin.

comments.delete

Hata türü	Hata ayrıntıları	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ı. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

comments.update

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	commentTextTooLong	Güncellenen comment kaynağının snippet.textOriginal özelliğinde ç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. Geçerli olduğundan emin olmak için istek gövdesindeki comment kaynağının yapısını kontrol edin.
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ı, yorumu veya yorum dizisini güncellemek üzere kullanıcının Google Hesabı ile birleştirilmelidir.
notFound (404)	commentNotFound	Belirtilen yorum bulunamadı. Doğruluğundan emin olmak için istek gövdesindeki id özelliğinin değerini kontrol edin.

üyeler

Aşağıdaki tablolarda, API'nin members 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.

members.list

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	channelMembershipsNotEnabled	İsteği yetkilendiren içerik üretici kanalında kanal üyelikleri etkinleştirilmemiştir.
badRequest (400)	invalidMode	mode parametre değeri geçersiz. Bu hata, pageToken parametresi belirtilenden farklı bir mod kullanılarak alınan bir jetonu belirtirse 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 seviye yok.
badRequest (400)	invalidFilterByMemberChannelId	filterByMemberChannelId parametre değeri geçersiz. Bu hata, filterByMemberChannelId parametre değeri 100'den fazla kanal belirtiyorsa oluşur.

membershipsLevels

Aşağıdaki tablolarda, API'nin members 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.

membershipsLevels.list

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

playlistItems

Aşağıdaki tablolarda, API'nin playlistItems 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.

playlistItems.delete

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

playlistItems.insert

Hata türü	Hata ayrıntıları	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 düzgün şekilde yetkilendirilmedi.
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 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 konumda olmasını istiyorsanız önce oynatma listesinin ayarlarında oynatma listesinin Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayarlar YouTube Video Yöneticisi'nden düzenlenebilir.
invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Oynatma listesine eklemeye çalıştığınız video zaten başka bir dizi oynatma listesinde.
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 bulunamıyor. Doğru olduğundan emin olmak için videoId özelliğinin değerini kontrol edin.
required (400)	channelIdRequired	İstek, gerekli channelId özelliği için bir değer belirtmiyor.
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ıları	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 bulunamadı.
notFound (404)	videoNotFound	İsteğin videoId parametresiyle tanımlanan video bulunamıyor.
required (400)	playlistIdRequired	Abone olma isteğinde gerekli playlistId özelliği için bir değer belirtilmiyor.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesindeki videoları listeleme özelliğini desteklemez. Örneğin, bir videoyu "Daha Sonra İzle" oynatma listenizde listeleyemezsiniz.

playlistItems.update

Hata türü	Hata ayrıntıları	Açıklama
forbidden (403)	playlistItemsNotAccessible	İstek, belirtilen oynatma listesi öğesini güncellemek için düzgün ş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	İstek, geçerli bir snippet özelliği belirtmiyor.
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 konumda olmasını istiyorsanız önce oynatma listesinin ayarlarında oynatma listesinin Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayarlar YouTube Video Yöneticisi'nden düzenlenebilir.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesindeki videoların güncellenmesini desteklemez. Ö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	İstek, gerekli channelId özelliği için bir değer belirtmiyor.
required (400)	playlistIdRequired	İstek, gerekli playlistId özelliği için bir değer belirtmiyor.
required (400)	playlistItemIdRequired	İstekle belirtilen çalma listesi öğesi kaynağı, güncellenen çalma 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ı tanımlanmaktadır. 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ıları	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 listesinin silinmesini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizi silemezsiniz.

playlists.list

Hata türü	Hata ayrıntıları	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 listesinin listelenmesini desteklemiyor. Örneğin, "Daha sonra izle" oynatma listenizi listeleyemezsiniz.

playlists.insert

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	defaultLanguageNotSetError	defaultLanguage, localizations olarak güncellenmelidir.
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 dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400)	maxPlaylistExceeded	Kanalda izin verilen maksimum oynatma listesi sayısı zaten mevcut olduğundan oynatma listesi oluşturulamaz.
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	İstek, oynatma listesi başlığını belirtmelidir.

playlists.update

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	defaultLanguageNotSetError	defaultLanguage, localizations olarak güncellenmelidir.
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 dokümanındaki yönergeleri uygulayarak bu değerleri güncelleyin.
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.
invalidValue (400)	playlistOperationUnsupported	API, belirtilen oynatma listesinin güncellenmesini desteklemez. Ö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ığını 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ıları	Açıklama
badRequest (400)	invalidChannelId	channelId parametresi geçersiz bir kanal kimliği belirtiyor.
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ı tanımlanmaktadır. 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ıları	Açıklama
forbidden (403)	subscriptionForbidden	İstek düzgün şekilde kimliği doğrulanmamış veya bu kanal için desteklenmiyor.
notFound (404)	subscriptionNotFound	Silmeye çalıştığınız abonelik bulunamıyor. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

subscriptions.insert

Hata türü	Hata ayrıntıları	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 olma özelliği desteklenmez.
forbidden (403)	subscriptionForbidden	İstek düzgün şekilde kimliği doğrulanmamış veya bu kanal için desteklenmiyor.
notFound (404)	publisherNotFound	İsteğin snippet.resourceId özelliği tarafından belirtilen kaynak bulunamadı.
notFound (404)	subscriberNotFound	İstekle tanımlanan abone bulunamadı.
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ıları	Açıklama
forbidden (403)	accountClosed	Abonenin hesabı kapatıldığı için abonelikler alınamadı.
forbidden (403)	accountSuspended	Abonenin hesabı askıya alındığı için abonelikler alınamadı.
forbidden (403)	subscriptionForbidden	İstekte bulunan kullanıcının, istenen aboneliklere erişmesine izin verilmiyor.
notFound (404)	subscriberNotFound	İstekle tanımlanan abone bulunamadı.

küçük resimler

Aşağıdaki tablolarda, API'nin thumbnails 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.

thumbnails.set

Hata türü	Hata ayrıntıları	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. Doğru olduğundan emin olmak için isteğin videoId parametresinin değerini kontrol edin.
tooManyRequests (429)	uploadRateLimitExceeded	Kanal, son zamanlarda çok fazla küçük resim yükledi. 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ıları	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ı tanımlanmaktadır. 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ıları	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ı tanımlanmaktadır. 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ıları	Açıklama
badRequest (400)	defaultLanguageNotSet	İstek, video ayrıntılarının varsayılan dili belirtilmeden 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 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 verilerinde geçersiz veya boş bir video başlığı belirtiliyor.
badRequest (400)	invalidVideoGameRating	İstek meta verilerinde geçersiz bir video oyunu derecelendirmesi belirtiliyor.
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.
badRequest (400)	mediaBodyRequired	İstek video içeriğini içermiyor.
badRequest (400)	uploadLimitExceeded	Kullanıcı, yükleyebileceği video sayısını aşmıştı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ıları	Açıklama
badRequest (400)	videoChartNotFound	İstenen video grafiği desteklenmiyor veya kullanılamıyor.
forbidden (403)	forbidden	İstek, video dosyasına veya işleme bilgilerine erişmek için uygun şekilde yetkilendirilmemiş. fileDetails, processingDetails ve suggestions bölümleri yalnızca videonun sahibine gösterilir.
forbidden (403)	forbidden	İstek, kullanıcı derecelendirme bilgilerine erişemiyor. Bu hata, istekte myRating parametresinin kullanılması için uygun yetkilendirme yapılmadığından kaynaklanabilir.
notFound (404)	videoNotFound	Almaya çalıştığınız video bulunamıyor. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

videos.delete

Hata türü	Hata ayrıntıları	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. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

videos.update

Hata türü	Hata ayrıntıları	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 verilerinde geçersiz veya boş bir video başlığı belirtiliyor.
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, canlı yayınlar için yerleştirilmiş oynatıcı sunma iznine sahip olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
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ıları	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	Derecelendirmeye çalıştığınız video derecelendirilemiyor. İ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 bulunamıyor. Doğru olduğundan emin olmak için isteğin id parametresinin değerini kontrol edin.

videos.reportAbuse

Hata türü	Hata ayrıntıları	Açıklama
badRequest (400)	invalidAbuseReason	İstek, reason_id alanı için beklenmeyen bir değer veya reason_id ve secondary_reason_id alanlarının bir kombinasyonunu 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ı tanımlanmaktadır. 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ıları	Açıklama
badRequest (400)	imageFormatUnsupported	Sağladığınız resim desteklenmeyen bir biçimde.
badRequest (400)	imageTooTall	Girdiğiniz resim çok uzun.
badRequest (400)	imageTooWide	Girdiğ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.

watermarks.unset

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