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 çağrının kota maliyeti 50 birimdir.

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 birinin yetkilendirilmesi 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ı bulunmaktadır:
  • id
  • snippet

İstek metni

İ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ğerler 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 ayrıntı için lütfen hata mesajı dokümanlarını inceleyin.

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ğında geçersiz özel emoji var.
badRequest (400) invalidCommentMetadata İstek meta verisi 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üleyen kişinin ileti dizisine yanıt verip veremeyeceğini belirtir.
badRequest (400) parentCommentIsPrivate Belirtilen üst yorum gizli. API, gizli yorumlara verilen yanıtları 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 olsa da genellikle isteğin girişinin geçersiz olduğunu gösterir. İstek gövdesindeki comment kaynağının yapısını kontrol ederek geçerli olduğundan emin olun.
forbidden (403) forbidden Yetersiz izinler nedeniyle yorum oluşturulamıyor. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
forbidden (403) ineligibleAccount API isteğini yetkilendirmek için kullanılan YouTube hesabı, yorum veya yorum ileti dizisi eklemek üzere kullanıcının Google hesabıyla birleştirilmelidir.
notFound (404) parentCommentNotFound Belirtilen üst yorum bulunamadı. İstek gövdesindeki snippet.parentId özelliğinin değerini kontrol ederek doğru olduğundan emin olun.

Deneyin.

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