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

Yaygın kullanım alanları

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir (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
  • snippet

İstek metni

İstek gövdesinde yorum kaynağı sağlayın. Bu kaynak için:

  • Bu özellikler için bir değer belirtmeniz gerekir:

    • snippet.textOriginal
    • snippet.parentId

  • Bu özellikler için değerler ayarlayabilirsiniz:

    • snippet.textOriginal

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir comment 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 lütfen hata mesajı belgelerine 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ş bırakılamaz.
badRequest (400) commentTextTooLong Eklenen comment kaynağının snippet.textOriginal özelliğinde çok fazla karakter var.
badRequest (400) invalidCustomEmoji Eklenen comment kaynağı geçersiz özel emoji'ler 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 ekleyemiyor. Bir commentThread kaynağında, snippet.canReply özelliği mevcut görüntüleyenin ileti dizisini yanıtlayıp yanıtlayamayacağını belirtir.
badRequest (400) parentCommentIsPrivate Belirtilen üst yorum gizli. API, özel 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 olabilir ancak genellikle isteğin 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 Yorum veya yorum dizisi eklemek için API isteğini yetkilendirmek üzere kullanılan YouTube hesabının kullanıcının Google Hesabı ile birleştirilmesi gerekir.
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ğini ve yanıtını görmek için APIs Explorer simgesini kullanın.