YouTube Data API - Errors

Bu belgede, YouTube Data API işlemlerinin döndürebileceği farklı hata türleri tanımlanmaktadır. Ayrıca, her bir yöntemin referans belgelerinde bu yöntemle ilgili hataların listesini de 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 çözümlenmesi gerekir ancak bu gerçekleşmiyor. İ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 özellikleri 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 varsa 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ı 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ı dosyası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ı dosyasını indirmek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
invalidValue (400) couldNotConvert Altyazı dosyası verileri, istenen dile ve/veya biçime dönüştürülemedi. İstenen tfmt ve tlang değerlerinin geçerli olduğundan ve istenen altyazı dosyasının snippet.status değerinin failed olmadığından emin olun.
notFound (404) captionNotFound Altyazı dosyası bulunamadı. 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ı dosyası içeriklerini içermiyor.
conflict (409) captionExists Belirtilen videoda, verilen snippet.language ve snippet.name ile altyazı dosyası zaten var. Bir videoda aynı dil için birden fazla parça olabilir ancak her parçanın farklı bir adı olmalıdır.

Bu hatayı düzeltmenin birden fazla yolu vardır. Mevcut 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ı dosyasını yüklemek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
invalidValue (400) invalidMetadata İstek, parçanın oluşturulmasını engelleyen geçersiz meta veri değerleri içeriyor. İsteğin snippet.language, snippet.name ve snippet.videoId özellikleri için geçerli değerler belirttiğ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ı dosyalarından biri veya daha fazlası bulunamadı. Bu hata, videoId parametresi gerçek bir videoyu tanımladığında ancak id parametresi mevcut olmayan altyazı dosyası kimliklerini veya diğer videolarla ilişkili parça kimliklerini tanımladığında 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ı dosyası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 bu 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ü bulunamadı.

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 ve channelSections kaynak dokümanındaki yönergeleri uygulayarak güncellemek için channelSections.list yöntemini kullanın.
badRequest (400) notEditable Bu kanal bölümü oluşturulamaz.
badRequest (400) styleRequired channelSection kaynağı, snippet.style alanı için bir değer belirtmelidir.
badRequest (400) targetInvalidCountry targeting.countries listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak dokümanındaki yönergeleri uygulayarak güncellemek için channelSections.list yöntemini kullanın.
badRequest (400) targetInvalidLanguage targeting.languages listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak dokümanındaki yönergeleri uygulayarak güncellemek için channelSections.list yöntemini kullanın.
badRequest (400) targetInvalidRegion targeting.regions listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak dokümanındaki yönergeleri uygulayarak 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 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ümleri 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ğundan kanal bölümüne eklenemez.
invalidValue (400) playlistsDuplicated İstek, yinelenen oynatma listeleri belirttiği için başarısız oldu.
invalidValue (400) playlistsNeeded snippet.type özelliğ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 Filtreleme ö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 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 ve channelSections kaynak dokümanındaki yönergeleri uygulayarak güncellemek için channelSections.list yöntemini kullanın.
badRequest (400) targetInvalidLanguage targeting.languages listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak dokümanındaki yönergeleri uygulayarak güncellemek için channelSections.list yöntemini kullanın.
badRequest (400) targetInvalidRegion targeting.regions listesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak ve channelSections kaynak dokümanındaki yönergeleri uygulayarak 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 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ümleri 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ğundan kanal bölümüne eklenemez.
invalidValue (400) playlistsDuplicated İstek, yinelenen oynatma listeleri belirttiği için başarısız oldu.
invalidValue (400) playlistsNeeded snippet.type özelliğ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ü bulunamadı.
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ümanlarındaki yönergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400) invalidCustomMessage İstek meta verileri geçersiz bir özel mesaj belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.items[].customMessage özelliğinin değerini kontrol edin.
badRequest (400) invalidDuration İstek meta verileri, invideoPromotion bölümünde geçersiz bir süre belirtiyor.
badRequest (400) invalidDuration İstek meta verileri, tanıtılan öğenin video oynatıcıda nasıl konumlandırılacağını belirlemek için geçersiz bir konum türü belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.position.type özelliğinin değerini kontrol edin.
badRequest (400) invalidRecentlyUploadedBy İstek meta verilerinde geçersiz bir kanal kimliği belirtiliyor. İsteğin gönderildiği kaynakta 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 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 belirtiyor. İsteğin gönderildiği kaynakta invideoPromotion.timing.offsetMs özelliğinin değerini kontrol edin.
badRequest (400) invalidTimingType İstek meta verileri, tanıtılan öğenin video oynatıcıda ne zaman gösterileceğini belirlemek için geçersiz bir zamanlama yöntemi belirtiyor. İsteğin gönderildiği kaynakta 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 belgelerindeki 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 videoyla ilgili yorum, videonun izleme sayfasında gösterilir.
badRequest (400) commentTextRequired Eklenen comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş 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ğruluğundan emin olmak için snippet.channelId özelliğinin değerini kontrol edin.
notFound (404) videoNotFound Belirtilen video bulunamadı. Doğruluğ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ı bulunamadı. İ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. 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, çalma 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, videoların belirtilen oynatma listesine eklenmesini 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ğruluğ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, çalma 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 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 İ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 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ı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 bulunamıyor.
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 belgelerindeki 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 belgelerindeki 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.

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 bulunamadı. 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 bulunamıyor.
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ını 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ı puanı 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 bulunamadı. 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ını 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 bulunamadı. İ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 bulunamadı. 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 Gönderdiğiniz resim çok uzun.
badRequest (400) imageTooWide Gönderdiğiniz resim çok geniş.
badRequest (400) mediaBodyRequired İstek, resim içeriğini içermiyor.
forbidden (403) forbidden Belirtilen kanal için filigran 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.