YouTube Data API - Errors
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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. |
ü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. |
ara
Aşağıdaki tablolarda, API'nin search kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, Yaygın istek hataları bölümünde listelenen hataları da döndürebilir.
search.list
| Hata türü | Hata ayrıntısı | Açıklama |
|---|
badRequest (400) | invalidChannelId | channelId parametresi geçersiz bir kanal kimliği belirtti. |
badRequest (400) | invalidLocation | location ve/veya locationRadius parametre değeri yanlış biçimlendirilmiş. |
badRequest (400) | invalidRelevanceLanguage | relevanceLanguage parametresi yanlış biçimlendirilmiş. |
badRequest (400) | invalidSearchFilter | İstek, geçersiz bir arama filtresi ve/veya kısıtlama kombinasyonu içeriyor. eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated veya videoType parametreleri için bir değer belirlerseniz type parametresini video olarak ayarlamanız gerekir. |
abonelikler
Aşağıdaki tablolarda, API'nin subscriptions kaynaklarıyla ilgili çağrılara yanıt olarak döndürdüğü hata mesajları tanımlanmaktadır. Bu yöntemler, 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. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-02-06 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-02-06 UTC."],[[["The YouTube Data API commonly returns errors such as `forbidden (403)` for authorization issues, `badRequest (400)` for invalid requests, and `notFound (404)` for missing resources."],["Specific API methods like `activities`, `captions`, `channelBanners`, `channelSections`, `playlists`, and `videos` have unique error conditions, including missing parameters, content issues, and permission constraints."],["Errors related to channel management, such as creating, deleting, listing, or updating channel sections or playlists, often involve issues with invalid IDs, missing required fields, exceeding limits, or conflicting configurations."],["Comment and comment thread errors can arise from insufficient permissions, disabled commenting, character limits, private comments, or attempting to reply to non-existent parent comments."],["Errors related to video operations may include problems with category IDs, descriptions, titles, privacy settings, invalid licensing, missing content, exceeding upload limits, and improper reporting of abuse."]]],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
yorumlar
comments.markAsSpamyöntemi artık desteklenmiyor.Aşağıdaki tablolarda, API'nin
commentskaynakları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.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundidveparentIdparametrelerinin doğru olduğundan emin olmak için değerlerini kontrol edin.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthorparametresi yalnızcamoderationStatusparametre değerirejectedise kullanılabilir.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidparametresinin değerlerinin doğru olduğundan emin olmak için değerleri kontrol edin.comments.insertbadRequest (400)commentTextRequiredcommentkaynağı,snippet.textOriginalözelliği için bir değer belirtmelidir. Yorumlar boş olamaz.badRequest (400)commentTextTooLongcommentkaynağı,snippet.textOriginalmülkünde çok fazla karakter içeriyor.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentIdmülkü tarafından tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemez.commentThreadkaynağındakisnippet.canReplymülkü, mevcut izleyicinin ileti dizisini yanıtlayıp yanıtlayamayacağını belirtir.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentkaynağı,snippet.parentIdmülkü için bir değer belirtmedi.badRequest (400)processingFailurecommentkaynağının yapısını kontrol edin.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdmülkünün değerini kontrol edin.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidparametresinin değerinin doğru olduğundan emin olun.comments.updatebadRequest (400)commentTextTooLongcommentkaynağı,snippet.textOriginalmülkünde çok fazla karakter içeriyor.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentkaynağının yapısını kontrol edin.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidmülkünün değerini kontrol edin.