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 kota maliyeti 50 birimdir.

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 kapsamların en az biriyle yetkilendirme yapılması 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 tüm parametreler 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ı yer almaktadır:
  • id
  • replies
  • snippet

İstek metni

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

Bu kaynak için aşağıdaki özelliklerin değerini 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 bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) channelOrVideoIdMissing Her yorum dizisi bir videoya bağlı olmalıdır. Kaynağın, snippet.channelId ve snippet.videoId özellikleri için değerler belirttiğinden emin olun. Bir videoyla ilgili yorum, videonun izleme sayfasında görünür.
badRequest (400) commentTextRequired Eklenen comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliği için bir değer belirtmelidir. Yorumlar boş bırakılamaz.
badRequest (400) commentTextTooLong Eklenen comment kaynağının snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter var.
badRequest (400) invalidCommentThreadMetadata İstek meta verileri geçersiz.
badRequest (400) processingFailure API sunucusu, isteği başarıyla işleyemedi. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. Geçerli olduğundan emin olmak için istek gövdesindeki commentThread kaynağının yapısını kontrol edin.
forbidden (403) forbidden Yetersiz izinler nedeniyle yorum dizisi oluşturulamadı. İstek düzgün şekilde yetkilendirilmemiş olabilir.
forbidden (403) ineligibleAccount API isteğini yetkilendirmek için kullanılan YouTube hesabı, yorum veya yorum dizisi eklemek üzere kullanıcının Google Hesabı ile birleştirilmelidir.
notFound (404) channelNotFound Belirtilen kanal bulunamadı. Doğru olduğundan emin olmak için snippet.channelId özelliğinin değerini kontrol edin.
notFound (404) videoNotFound Belirtilen video bulunamadı. Doğru olduğundan emin olmak için snippet.videoId özelliğinin değerini kontrol edin.

Deneyin.

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