YouTube Data API - Errors

Bu dokümanda, YouTube Data API işlemlerinin döndürebileceği farklı hata türleri tanımlanmaktadır. Her bir yöntemin hata listesini ilgili yöntemin referans dokümanlarında da 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 bir ş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 Kimlik doğrulaması yapılan kullanıcı, belirtilen Google Hesabı adına işlem yapamaz.
forbidden (403) authenticatedUserAccountClosed Kimliği doğrulanmış kullanıcının YouTube hesabı kapatılır. 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 Kimlik doğrulaması yapılan kullanıcının YouTube hesabı askıya alınır. 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) 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 parametresi kullanılıyorsa onBehalfOfContentOwnerChannel parametresini de ayarlamanız gerekir.
forbidden (403) channelClosed İstekte belirtilen kanal kapatılmış.
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 yetkisi yok.
forbidden (403) insufficientPermissions İstek için sağlanan OAuth 2.0 jetonu, istenen verilere erişmek için yeterli olmayan 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 İstekte mine parametresinin kullanılması 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ırmanız, onBehalfOfContentOwner parametresini kaldırarak YouTube kullanıcısı olarak kimlik doğrulamanız veya çağrılan yöntem için uygunsa onBehalfOfContentOwnerChannel parametresini sağlayarak iş ortağının kanallarından biri gibi davranmanız gerekir.
badRequest (400) invalidPart İsteğin part parametresi, aynı anda yazılamayan bazı bölümleri belirtir.
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 düzgün şekilde yetkilendirilmemiş.
unauthorized (401) youtubeSignupRequired Bu hata, kullanıcının bağlantısı kaldırılmış bir Google Hesabı olduğunu gösterir. Yani kullanıcının Google Hesabı vardır ancak YouTube kanalı yoktur. Bu tür kullanıcılar, videoları derecelendirme veya watch_later oynatma listesine video ekleme gibi kullanıcı yetkilendirmesine bağlı birçok özelliğe erişebilir. Ancak örneğin, kullanıcının video yükleyebilmek için bir YouTube kanalına sahip olması gerekir. Gmail hesabı veya Android cihazı olan kullanıcıların Google Hesabı vardır ancak bu Google Hesabı bir YouTube kanalına bağlanmamış olabilir.

Bu hata genellikle OAuth 2.0 Hizmet Hesabı akışını kullanmayı denediğinizde 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ınmıştır. Blog yayınında API 2.1 sürümü için hata açıklansa da hatanın anlamı hâlâ geçerlidir.

etkinlikler

YouTube, kanal bülteni özelliğini kullanımdan kaldırdı. activities.insert yöntemi artık desteklenmiyor.

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, Yaygın 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 parametresi tarafından tanımlanan kanal kimliği bulunamıyor.
notFound (404) homeChannelNotFound Şu anda kimliği doğrulanmış kullanıcı için YouTube ana sayfası feed'i bulunamıyor.
unauthorized (401) authorizationRequired İstek home parametresini kullanıyor ancak düzgün ş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, Yaygın 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ı parçasını silmek için yeterli değil. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
notFound (404) captionNotFound Altyazı parçası bulunamadı. İsteğin id parametresinin değerinin 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ı parçasını indirmek için yeterli değil. İstek düzgün bir ş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ı kanalının snippet.status değerinin failed olmadığından emin olun.
notFound (404) captionNotFound Altyazı parçası bulunamadı. İsteğin id parametresinin değerinin doğru olduğundan emin olun.

captions.insert

Hata türü Hata ayrıntısı Açıklama
badRequest (400) contentRequired İstek, altyazı parçası içeriklerini içermiyor.
conflict (409) captionExists Belirtilen videoda, belirtilen snippet.language ve snippet.name ile altyazı parçası zaten mevcut. 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ı silip yeni bir parça ekleyebilir veya yeni parçayı eklemeden önce 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 bir şekilde yetkilendirilmemiş olabilir.
invalidValue (400) invalidMetadata İstekte, parçanın oluşturulmasını engelleyen geçersiz meta veri değerleri bulunuyor. İstekte snippet.language, snippet.name ve snippet.videoId özellikleri için geçerli değerlerin belirtildiğinden emin olun. snippet.isDraft özelliği de eklenebilir ancak gerekli değildir.
notFound (404) videoNotFound videoId parametresi tarafından 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ı parçası alınamadı. İstek düzgün bir ş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ımlamasına rağmen id parametresi var olmayan altyazı parça kimliklerini veya diğer videolarla ilişkili parça kimliklerini tanımladığında ortaya çıkar. İsteğin id ve videoId parametrelerinin doğru olduğundan emin olmak için değerlerini kontrol edin.
notFound (404) videoNotFound videoId parametresi tarafından tanımlanan video bulunamadı.

captions.update

Hata türü Hata ayrıntısı Açıklama
badRequest (400) contentRequired İstek, güncellenmiş bir altyazı dosyası yüklemedi. sync parametresi true olarak ayarlandıysa gerçek parça içerikleri gereklidir.
forbidden (403) forbidden İstekte belirtilen izinler, altyazı parçasını güncellemek için yeterli değil. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
notFound (404) captionNotFound Belirtilen altyazı parçası bulunamadı. İsteğin id parametresinin değerinin 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ı tanımlanmaktadır. Bu yöntemler, Yaygın 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 bu albümdeki 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, Yaygın 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 düzgün şekilde kimlik doğrulanmadı veya bu kanal için desteklenmiyor.
invalidValue (400) idInvalid id mülkü geçersiz bir kanal bölümü kimliği belirtiyor.
invalidValue (400) idRequired id mülkü, 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ısı Açıklama
badRequest (400) defaultLanguageNotSetError channelSection kaynağının snippet.defaultLanguage mülkü, ilgili kaynak için localizations nesnesini başarılı bir şekilde eklemek veya güncellemek üzere ayarlanmalıdır.
badRequest (400) invalidLanguage localizations nesnesinin dil anahtarlarından biri doğrulanamadı. Geçerli değerleri almak ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre güncellemek için channelSections.list yöntemini kullanın.
badRequest (400) notEditable Bu kanal bölümü oluşturulamıyor.
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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 düzgün şekilde kimlik doğrulanmadı veya bu kanal için desteklenmiyor.
invalidValue (400) channelNotActive Belirtilen kanallardan en az biri etkin değil.
invalidValue (400) channelsDuplicated Yinelenen kanallar belirtildiği için istek başarısız oldu.
invalidValue (400) channelsNeeded snippet.type mülkünün değeri multipleChannels ise contentDetails.channels[] mülkü belirtilmeli ve en az bir kanal belirtilmelidir.
invalidValue (400) channelsNotExpected İstekte sağlanan kaynakta contentDetails.channels[] mülkü için bir değer belirtilmiş ancak bu tür kanal bölümlerinde kanal beklenmez.
invalidValue (400) contentDetailsNeeded Eklediğiniz kaynak, bu tür kanal bölümü için bir contentDetails nesnesi içermelidir.
invalidValue (400) inValidPosition snippet.position mülkü geçersiz bir değer içeriyor.
invalidValue (400) maxChannelSectionExceeded Kanalda maksimum sayıda kanal bölümü bulunduğu için istek tamamlanamıyor.
invalidValue (400) maxChannelsExceeded Kanal bölümüne çok fazla kanal dahil edilmeye çalışıldığı için istek başarısız oldu.
invalidValue (400) maxPlaylistExceeded Kanal bölümüne çok fazla oynatma listesi eklenmeye çalışıldığı için istek başarısız oldu.
invalidValue (400) onePlaylistNeeded snippet.type özelliğinin değeri singlePlaylist ise contentDetails.playlists[] özelliği tam olarak bir oynatma listesi belirtmelidir.
invalidValue (400) ownChannelInChannels Kendi kanalınızı, ilgili kanalda görünen bir kanal bölümüne dahil edemezsiniz.
invalidValue (400) playlistIsPrivate Belirtilen oynatma listelerinden biri veya daha fazlası gizli olduğu için kanal bölümüne dahil edilemez.
invalidValue (400) playlistsDuplicated Yinelenen oynatma listeleri belirtildiği için istek 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 İstekte sağlanan kaynakta contentDetails.playlists[] mülkü için bir değer belirtilmiş ancak bu tür kanal bölümlerinde oynatma listeleri beklenmez.
invalidValue (400) snippetNeeded Kanal bölümünü oluşturmak için bir snippet belirtmeniz gerekir.
invalidValue (400) titleLengthExceeded snippet.title mülkünün değeri çok uzun.
invalidValue (400) titleRequired snippet.type mülkünün değeri multiplePlaylists veya multipleChannels ise snippet.title mülkü 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ğu için 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 mülkü, ilgili kaynak için localizations nesnesini başarılı bir şekilde eklemek veya güncellemek üzere ayarlanmalıdır.
badRequest (400) invalidLanguage localizations nesnesinin dil anahtarlarından biri doğrulanamadı. Geçerli değerleri almak ve a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 a href="/youtube/v3/docs/channelSections#resource">channelSections kaynak dokümanlarında yer alan yönergelere göre 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 düzgün şekilde kimlik doğrulanmadı veya bu kanal için desteklenmiyor.
invalidValue (400) channelNotActive Belirtilen kanallardan en az biri etkin değil.
invalidValue (400) channelsDuplicated Yinelenen kanallar belirtildiği için istek başarısız oldu.
invalidValue (400) channelsNeeded snippet.type mülkünün değeri multipleChannels ise contentDetails.channels[] mülkü belirtilmeli ve en az bir kanal belirtilmelidir.
invalidValue (400) channelsNotExpected İstekte sağlanan kaynakta contentDetails.channels[] mülkü için bir değer belirtilmiş ancak bu tür kanal bölümlerinde kanal beklenmez.
invalidValue (400) contentDetailsNeeded Güncellediğiniz kaynak, bu tür kanal bölümü için bir contentDetails nesnesi içermelidir.
invalidValue (400) idInvalid id mülkü geçersiz bir kanal bölümü kimliği belirtiyor.
invalidValue (400) idRequired id mülkü, güncellenen kanal bölümünü tanımlayan bir değer belirtmelidir.
invalidValue (400) inValidPosition snippet.position mülkü geçersiz bir değer içeriyor.
invalidValue (400) maxChannelsExceeded Kanal bölümüne çok fazla kanal dahil edilmeye çalışıldığı için istek başarısız oldu.
invalidValue (400) maxPlaylistExceeded Kanal bölümüne çok fazla oynatma listesi eklenmeye çalışıldığı için istek başarısız oldu.
invalidValue (400) onePlaylistNeeded snippet.type özelliğinin değeri singlePlaylist ise contentDetails.playlists[] özelliği tam olarak bir oynatma listesi belirtmelidir.
invalidValue (400) ownChannelInChannels Kendi kanalınızı, ilgili kanalda görünen bir kanal bölümüne dahil edemezsiniz.
invalidValue (400) playlistIsPrivate Belirtilen oynatma listelerinden biri veya daha fazlası gizli olduğu için kanal bölümüne dahil edilemez.
invalidValue (400) playlistsDuplicated Yinelenen oynatma listeleri belirtildiği için istek 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 İstekte sağlanan kaynakta contentDetails.playlists[] mülkü için bir değer belirtilmiş ancak bu tür kanal bölümlerinde oynatma listeleri beklenmez.
invalidValue (400) snippetNeeded Kanal bölümünü güncellemek için bir snippet belirtmeniz gerekir.
invalidValue (400) titleLengthExceeded snippet.title mülkünün değeri çok uzun.
invalidValue (400) titleRequired snippet.type mülkünün değeri multiplePlaylists veya multipleChannels ise snippet.title mülkü 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ı 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, Yaygın 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 Aşağıdaki 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 parametresi tarafından belirtilen kanal isteği desteklemiyor veya istek düzgün bir şekilde yetkilendirilmemiş.
notFound (404) categoryNotFound categoryId parametresi tarafından tanımlanan kategori bulunamıyor. Geçerli değerlerin listesini almak için guideCategories.list yöntemini kullanın.
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ında yer alan yönergelere göre mülk 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'ü güncelleyecek şekilde ayarlanmalıdır.
badRequest (400) invalidBrandingOption Belirttiğiniz markalaşma ayarlarından biri yok. Geçerli değerleri almak için channels.list yöntemini kullanın ve bunları channels kaynak dokümanlarında yer alan yönergelere göre güncellediğinizden emin olun.
badRequest (400) invalidCustomMessage İstek meta verileri geçersiz bir özel mesaj belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.items[].customMessage mülkünün 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ü belirtir. İsteğin gönderildiği kaynakta invideoPromotion.position.type mülkünün değerini kontrol edin.
badRequest (400) invalidRecentlyUploadedBy İstek meta verileri geçersiz bir kanal kimliği belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.items[].id.recentlyUploadedBy mülkünün değerini kontrol edin.
badRequest (400) invalidTimingOffset İstek meta verileri, invideoPromotion bölümünde geçersiz bir zamanlama ofseti 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 belirtir. İsteğin gönderildiği kaynakta invideoPromotion.timing.offsetMs mülkünün 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 kaynakta invideoPromotion.timing.type mülkünün değerini kontrol edin.
badRequest (400) localizationValidationError localizations nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için channels.list yöntemini kullanın ve kanallar kaynak dokümanlarında belirtilen yönergelere göre güncellediğinizden emin olun.
badRequest (400) tooManyPromotedItems invideoPromotion bölümünde izin verilen tanıtılan öğelerin 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önderdiği channel kaynağındaki id mülkünün değerini kontrol edin.
forbidden (403) websiteLinkNotAllowed Belirtilen web sitesi URL'sine izin verilmiyor.
notFound (404) channelNotFound id parametresi ile belirtilen kanal bulunamıyor veya kanalda markalaşma 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 verileri, invideoPromotion bölümünde bir öğe belirtmelidir.
required (400) requiredTimingOffset YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde varsayılan bir zamanlama ofseti belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.offsetMs mülkünün değerini ayarlayın.
required (400) requiredTimingOffset YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için istek meta verilerinde bir zamanlama ofseti belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.timing.offsetMs mülkünün 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 mülkünün 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 mülkünün 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 mülkünün 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, Yaygın 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. Geçerli olduğundan emin olmak için istek gövdesinde commentThread kaynağının yapısını kontrol edin.
forbidden (403) commentsDisabled videoId parametresi ile tanımlanan videoda yorumlar devre dışı bırakılmıştır.
forbidden (403) forbidden İstekte bulunulan yorumlardan biri veya daha fazlası, yetersiz izinler nedeniyle alınamıyor. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
notFound (404) channelNotFound allThreadsRelatedToChannelId parametresi tarafından tanımlanan kanal bulunamadı.
notFound (404) commentThreadNotFound Belirtilen yorum ileti dizilerinden biri veya daha fazlası bulunamıyor. İsteğin id parametresinin doğru olduğundan emin olmak için değerlerini kontrol edin.
notFound (404) videoNotFound videoId parametresi tarafından 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. Video izleme sayfasında bir videoyla ilgili yorum gösterilir.
badRequest (400) commentTextRequired Eklenmekte olan comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş olamaz.
badRequest (400) commentTextTooLong Eklenmekte olan comment kaynağı, snippet.topLevelComment.snippet.textOriginal mülkünde çok fazla karakter içeriyor.
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övdesinde commentThread kaynağının yapısını kontrol edin.
forbidden (403) forbidden Yetersiz izinler nedeniyle yorum mesaj dizisi oluşturulamadı. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) ineligibleAccount Yorum veya yorum mesaj dizisi eklemek için API isteğini yetkilendirmek üzere kullanılan YouTube hesabının, kullanıcının Google Hesabı ile birleştirilmesi gerekir.
notFound (404) channelNotFound Belirtilen kanal bulunamadı. snippet.channelId mülkünün değerinin doğru olduğundan emin olun.
notFound (404) videoNotFound Belirtilen video bulunamadı. snippet.videoId mülkünün değerinin doğru olduğundan emin olun.

yorumlar

comments.markAsSpam yöntemi artık desteklenmiyor.

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, Yaygın 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 İstekte bulunulan yorumlardan biri veya daha fazlası, yetersiz izinler nedeniyle alınamıyor. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
notFound (404) commentNotFound Belirtilen yorumlardan biri veya daha fazlası bulunamıyor. İsteğin id ve parentId parametrelerinin doğru olduğundan emin olmak için değerlerini kontrol edin.

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 bir ş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 olmak için değerleri kontrol edin.

comments.insert

Hata türü Hata ayrıntısı Açıklama
badRequest (400) commentTextRequired Eklenmekte olan comment kaynağı, snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş olamaz.
badRequest (400) commentTextTooLong Eklenmekte olan comment kaynağı, snippet.textOriginal mülkünde çok fazla karakter içeriyor.
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 ekleyemez. commentThread kaynağındaki snippet.canReply mülkü, mevcut izleyicinin ileti dizisini yanıtlayıp yanıtlayamayacağını belirtir.
badRequest (400) parentCommentIsPrivate Belirtilen üst yorum gizli. API, gizli yorumlara verilen yanıtları desteklemez.
badRequest (400) parentIdMissing Eklenen yorum, bir üst yoruma bağlı olmalıdır. Ancak API isteğinin gövdesinde bulunan comment kaynağı, snippet.parentId mülkü 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övdesinde comment kaynağının yapısını kontrol edin.
forbidden (403) forbidden Yetersiz izinler nedeniyle yorum oluşturulamıyor. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) ineligibleAccount Yorum veya yorum mesaj dizisi eklemek için API isteğini yetkilendirmek üzere kullanılan YouTube hesabının, kullanıcının Google Hesabı ile birleştirilmesi gerekir.
notFound (404) parentCommentNotFound Belirtilen üst yorum bulunamadı. Doğruluğundan emin olmak için istek gövdesinde snippet.parentId mülkünün değerini kontrol edin.

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 bir şekilde yetkilendirilmemiş olabilir.
notFound (404) commentNotFound Belirtilen yorum bulunamadı. İsteğin id parametresinin değerinin doğru olduğundan emin olun.

comments.update

Hata türü Hata ayrıntısı Açıklama
badRequest (400) commentTextTooLong Güncellenen comment kaynağı, snippet.textOriginal mülkünde çok fazla karakter içeriyor.
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övdesinde comment kaynağının yapısını kontrol edin.
forbidden (403) forbidden Yetersiz izinler nedeniyle yorum güncellenemedi. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) ineligibleAccount Bir yorumu veya yorum ileti dizisini güncellemek için API isteğini yetkilendirmek üzere kullanılan YouTube hesabının, kullanıcının Google Hesabı ile birleştirilmesi gerekir.
notFound (404) commentNotFound Belirtilen yorum bulunamadı. Doğruluğundan emin olmak için istek gövdesinde id mülkünün 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, Yaygın 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şse
badRequest (400) invalidMode mode parametresinin değeri geçersiz. Bu hata, pageToken parametresi belirtilenden farklı bir mod kullanılarak alınan bir jeton belirtiyorsa ortaya çıkabilir.
badRequest (400) invalidPageToken pageToken parametresinin değeri geçersiz. Bu hata, istekte kullanılan sayfa jetonunun süresi dolmuşsa ortaya çıkar.
badRequest (400) invalidHasAccessToLevel hasAccessToLevel parametresinin değeri geçersiz. Belirtilen id ile seviye yok.
badRequest (400) invalidFilterByMemberChannelId filterByMemberChannelId parametresinin değeri geçersiz. Bu hata, filterByMemberChannelId parametresi değeri 100'den fazla kanal belirtiyorsa meydana gelir.

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, Yaygın 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şse

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, Yaygın 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 bulunamıyor.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesinden video silme özelliğini desteklemez. Örneğin, yüklenen videolar oynatma listenizdeki bir videoyu silemezsiniz.

playlistItems.insert

Hata türü Hata ayrıntısı Açıklama
duplicate videoAlreadyInPlaylist Oynatma listesine eklemeye çalıştığınız video zaten oynatma listesindedir.
forbidden (403) playlistContainsMaximumNumberOfVideos Oynatma listesi zaten izin verilen maksimum öğe sayısını içeriyor.
forbidden (403) playlistItemsNotAccessible İstek, belirtilen oynatma listesi öğesini eklemek için uygun şekilde yetkilendirilmemiş.
invalidValue (400) invalidContentDetails İstekteki contentDetails mülkü geçerli değil. Bunun nedeni contentDetails.note alanının 280 karakterden uzun olması olabilir.
invalidValue (400) invalidPlaylistItemPosition İstek, oynatma listesi öğesinin konumunu geçersiz veya desteklenmeyen bir değere ayarlamaya çalışıyor. Kaynağın snippet alanındaki position mülkünün değerini kontrol edin.
invalidValue (400) invalidResourceType Kaynak kimliği için belirtilen type bu işlem için desteklenmiyor. Kaynak kimliği, oynatma listesine eklenen öğeyi tanımlar (ör. youtube#video).
invalidValue (400) manualSortRequired İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışır ancak oynatma listesi manuel sıralama kullanmaz. (Ö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ı giderebilirsiniz. Oynatma listesi öğesinin listede belirli bir konumda olmasını istiyorsanız önce oynatma listesinin ayarlarından Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayarları YouTube Video Yöneticisi'nden düzenleyebilirsiniz.
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 desteklemez. Örneğin, yüklenen videolar oynatma listenize video ekleyemezsiniz.
notFound (404) playlistNotFound İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamıyor.
notFound (404) videoNotFound Oynatma listesine eklemeye çalıştığınız video bulunamıyor. videoId mülkünün değerinin doğru olduğundan emin olmak için değeri 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 bir resourceId belirttiği bir kaynak içermelidir.

playlistItems.list

Hata türü Hata ayrıntısı Açıklama
forbidden (403) playlistItemsNotAccessible İstek, belirtilen oynatma listesini almak için uygun şekilde yetkilendirilmemiş.
notFound (404) playlistNotFound İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamıyor.
notFound (404) videoNotFound İsteğin videoId parametresi ile tanımlanan video bulunamıyor.
required (400) playlistIdRequired Abone olma isteği, gerekli playlistId mülkü için bir değer belirtmiyor.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesindeki videoları listelemeyi desteklemez. Ö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üncelleme yetkisine sahip değil.
invalidValue (400) invalidPlaylistItemPosition İstek, oynatma listesi öğesinin konumunu geçersiz veya desteklenmeyen bir değere ayarlamaya çalışıyor. Kaynağın snippet alanındaki position mülkünün değerini kontrol edin.
invalidValue (400) invalidResourceType Kaynak kimliği için belirtilen type bu işlem için desteklenmiyor. Kaynak kimliği, oynatma listesine eklenen öğeyi tanımlar (ör. youtube#video).
invalidValue (400) invalidSnippet İstek, geçerli bir snippet mülkü belirtmiyor.
invalidValue (400) manualSortRequired İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışır ancak oynatma listesi manuel sıralama kullanmaz. (Ö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ı giderebilirsiniz. Oynatma listesi öğesinin listede belirli bir konumda olmasını istiyorsanız önce oynatma listesinin ayarlarından Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayarları YouTube Video Yöneticisi'nden düzenleyebilirsiniz.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesindeki videoları güncelleme özelliğini desteklemez. Örneğin, yüklenen videolar oynatma listenizdeki bir videoyu güncelleyemezsiniz.
notFound (404) playlistItemNotFound İsteğin id mülküyle tanımlanan oynatma listesi öğesi bulunamıyor.
notFound (404) playlistNotFound İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamıyor.
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 İstekte belirtilen oynatma listesi öğesi kaynağı, güncellenen oynatma listesi öğesini tanımlamak için id mülkünü 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, Yaygın 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 uygun şekilde yetkilendirilmemiştir.
notFound (404) playlistNotFound İsteğin id parametresi ile tanımlanan oynatma listesi bulunamıyor.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesinin silinmesini desteklemez. Ö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ılmış.
forbidden (403) channelSuspended channelId parametresinde belirtilen kanal askıya alındı.
forbidden (403) playlistForbidden İsteğin id parametresi ile tanımlanan oynatma listesi isteği desteklemiyor veya istek için uygun yetkilendirme sağlanmamış.
notFound (404) channelNotFound channelId parametresinde belirtilen kanal bulunamıyor.
notFound (404) playlistNotFound İsteğin id parametresiyle tanımlanan oynatma listesi bulunamıyor.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesini listelemeyi desteklemez. Örneğin, "Daha sonra izle" oynatma listenizi listeleyebilirsiniz.

playlists.insert

Hata türü Hata ayrıntısı Açıklama
badRequest (400) defaultLanguageNotSetError defaultLanguage, localizations'ü güncelleyecek şekilde ayarlanmalıdır.
badRequest (400) localizationValidationError localizations nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için playlists.list yöntemini kullanın ve playlists kaynak dokümanlarında belirtilen yönergelere göre güncellediğinizden emin olun.
badRequest (400) maxPlaylistExceeded Kanalda izin verilen maksimum sayıda oynatma listesi bulunduğu için oynatma listesi oluşturulamıyor.
forbidden (403) playlistForbidden Bu işlem yasaktır veya istek uygun ş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'ü güncelleyecek şekilde ayarlanmalıdır.
badRequest (400) localizationValidationError localizations nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için playlists.list yöntemini kullanın ve playlists kaynak dokümanlarında belirtilen yönergelere göre güncellediğinizden emin olun.
forbidden (403) playlistForbidden Bu işlem yasaktır veya istek uygun şekilde yetkilendirilmemiştir.
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 desteklemez. Örneğin, yüklenen videolar oynatma listenizin özelliklerini güncelleyemezsiniz.
notFound (404) playlistNotFound İsteğin id parametresiyle tanımlanan oynatma listesi bulunamıyor.
required (400) playlistTitleRequired İstekte bir oynatma listesi başlığı belirtilmelidir.

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, Yaygın 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 düzgün şekilde kimlik doğrulanmadı veya bu kanal için desteklenmiyor.
notFound (404) subscriptionNotFound Silmek istediğiniz abonelik bulunamıyor. İsteğin id parametresinin değerinin 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ınıza 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 için kimlik doğrulaması düzgün şekilde yapılmamış veya bu kanalda desteklenmiyor.
notFound (404) publisherNotFound İsteğin snippet.resourceId mülkü tarafından belirtilen kaynak bulunamıyor.
notFound (404) subscriberNotFound İstekte belirtilen abone bulunamadı.
required (400) publisherRequired İstekte belirtilen abonelik kaynağı, abone olunan kanalı tanımlamak için snippet.resourceId mülkünü kullanmalıdır.

subscriptions.list

Hata türü Hata ayrıntısı Açıklama
forbidden (403) accountClosed Abonenin hesabı kapalı olduğu 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 İstekte belirtilen 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, Yaygın 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 bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) forbidden Kimliği doğrulanan kullanıcının özel video küçük resimleri yükleme ve ayarlama izinleri yok.
notFound (404) videoNotFound Küçük resmini eklemeye çalıştığınız video bulunamıyor. İsteğin videoId parametresinin değerinin doğru olduğundan emin olun.
tooManyRequests (429) uploadRateLimitExceeded Kanal yakın zamanda ç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, Yaygın 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 bir ş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, Yaygın 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 parametresi tarafından 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, Yaygın 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 mülkü 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ı belirtir.
badRequest (400) invalidRecordingDetails İstek meta verilerindeki recordingDetails nesnesi geçersiz kayıt ayrıntılarını belirtir.
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) 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ünceller ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamazsa ortaya çıkar.
badRequest (400) mediaBodyRequired İstek, video içeriğini içermiyor.
badRequest (400) uploadLimitExceeded Kullanıcı, yükleyebileceği video sayısını aştı.
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ı ayarlamaya ç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 İstek, video dosyasına veya işleme bilgilerine erişmek için uygun şekilde yetkilendirilmemiş. fileDetails, processingDetails ve suggestions bölümlerine yalnızca videonun sahibi erişebilir.
forbidden (403) forbidden İstek, kullanıcı puanı bilgilerine erişemiyor. Bu hata, istek myRating parametresini kullanmak için uygun şekilde yetkilendirilmediğinden oluşabilir.
notFound (404) videoNotFound Almak istediğiniz video bulunamıyor. İsteğin id parametresinin değerinin doğru olduğundan emin olun.

videos.delete

Hata türü Hata ayrıntısı Açıklama
forbidden (403) forbidden Silmek istediğiniz video silinemiyor. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
notFound (404) videoNotFound Silmek istediğiniz video bulunamıyor. İsteğin id parametresinin değerinin 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 mülkü 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ı ayarlamaya çalışıyor.
badRequest (400) invalidDescription İstek meta verileri geçersiz bir video açıklaması belirtiyor.
badRequest (400) invalidPublishAt İstek meta verileri, geçersiz bir planlanmış yayınlama zamanı belirtir.
badRequest (400) invalidRecordingDetails İstek meta verilerindeki recordingDetails nesnesi geçersiz kayıt ayrıntılarını belirtir.
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ünceller ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamazsa ortaya çıkar.
forbidden (403) forbidden Erişim yasak. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) forbiddenEmbedSetting İstek, video için geçersiz bir yerleştirme ayarı ayarlamaya çalışıyor. Bazı kanalların canlı yayınlarda yerleştirilmiş oynatıcı sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.
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ı ayarlamaya çalışıyor.
notFound (404) videoNotFound Güncellemeye çalıştığınız video bulunamıyor. Doğru olduğundan emin olmak için istek gövdesinde id alanının değerini kontrol edin.

videos.rate

Hata türü Hata ayrıntısı Açıklama
badRequest (400) emailNotVerified Kullanıcı, derecelendirmeden ö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 puanlanabilir.
forbidden (403) forbidden Derecelendirmeye çalıştığınız video derecelendirilemiyor. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) videoRatingDisabled Derecelendirme yapmaya çalıştığınız videonun sahibi, videonun derecelendirmelerini devre dışı bırakmış olabilir.
notFound (404) videoNotFound Puanlamaya çalıştığınız video bulunamadı. İsteğin id parametresinin değerinin doğru olduğundan emin olun.

videos.reportAbuse

Hata türü Hata ayrıntısı 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 diliminde çok fazla istek göndermiştir.
forbidden (403) forbidden
notFound (404) videoNotFound Kötüye kullanım bildirmeye çalıştığınız video bulunamadı.

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, Yaygın 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 Sağladığınız resmin biçimi desteklenmiyor.
badRequest (400) imageTooTall Sağladığınız 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.