CommentThreads: insert

Yeni bir üst düzey yorum oluşturur. Mevcut bir yoruma yanıt eklemek için bunun yerine comments.insert yöntemini kullanın.

Kota etkisi: Bu yönteme yapılan bir çağrının 50 birim kota maliyeti olur.

Yaygın kullanım alanları

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/commentThreads

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen parametrelerin tümü sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresi, API yanıtının içereceği özellikleri tanımlar. Parametre değerini snippet olarak ayarlayın. snippet bölümünün kota maliyeti 2 birimdir.

Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları bulunmaktadır:
  • id
  • replies
  • snippet

İstek içeriği

İstek gövdesinde bir commentThread kaynağı sağlayın.

Bu kaynak için aşağıdaki özelliklere yönelik bir değer belirtmeniz gerekir:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir commentThread kaynağı döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için hata mesajı dokümanlarına göz atın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) channelOrVideoIdMissing Her yorum ileti dizisinin bir videoya bağlı olması gerekir. Kaynağın snippet.channelId ve snippet.videoId özelliklerinin değerlerini belirttiğinden emin olun. Videodaki yorumlar, videonun izleme sayfasında görünür.
badRequest (400) commentTextRequired Eklenen comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş olamaz.
badRequest (400) commentTextTooLong Eklenen comment kaynağı snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter içeriyor.
badRequest (400) invalidCommentThreadMetadata İstek meta verileri geçersiz.
badRequest (400) processingFailure API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabileceği gibi, genellikle istek 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 ileti 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 için kullanıcının Google Hesabı ile birleştirilmelidir.
notFound (404) channelNotFound Belirtilen kanal bulunamadı. snippet.channelId özelliğinin değerinin doğru olup olmadığını kontrol edin.
notFound (404) videoNotFound Belirtilen video bulunamadı. snippet.videoId özelliğinin değerinin doğru olup olmadığını kontrol edin.

Deneyin.

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer kullanın.