Comments: insert

Mevcut bir yoruma yanıt oluşturur. Not: Üst düzey yorum oluşturmak için commentThreads.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/comments

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
  • snippet

İstek içeriği

İstek gövdesinde bir yorum kaynağı sağlayın. Söz konusu kaynak için:

  • Şu özellikler için bir değer belirtmelisiniz:

    • snippet.textOriginal
    • snippet.parentId

  • Şu özellikler için değer ayarlayabilirsiniz:

    • snippet.textOriginal

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir yorum 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 lütfen hata mesajı dokümanlarına bakın.

Hata türü Hata ayrıntısı 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ğı snippet.textOriginal özelliğinde çok fazla karakter içeriyor.
badRequest (400) invalidCustomEmoji Eklenen comment kaynağı geçersiz özel emoji içeriyor.
badRequest (400) invalidCommentMetadata İstek meta verileri geçersiz.
badRequest (400) operationNotSupported API kullanıcısı, snippet.parentId mülkü tarafından tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemez. Bir commentThread kaynağında snippet.canReply özelliği, geçerli görüntüleyenin ileti dizisine yanıt verip veremeyeceğini ifade eder.
badRequest (400) parentCommentIsPrivate Belirtilen üst yorum gizli. API, gizli yorumların yanıtlarını desteklemez.
badRequest (400) parentIdMissing Eklenen yorum bir üst yoruma bağlı olmalı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 olabileceği gibi, genellikle istek 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 için kullanıcının Google hesabıyla birleştirilmelidir.
notFound (404) parentCommentNotFound Belirtilen üst yorum bulunamadı. İstek gövdesinde snippet.parentId özelliği 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.