Comments: setModerationStatus

Bir veya daha fazla yorumun denetleme durumunu ayarlar. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir.

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/setModerationStatus

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gereklidir (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
id string
id parametresi, denetleme durumunu güncellediğiniz yorumları tanımlayan kimliklerin virgülle ayrılmış listesini belirtir.
moderationStatus string
Belirtilen yorumların yeni denetleme durumunu tanımlar.

Kabul edilebilir değerler şunlardır:
  • heldForReview – Yorumu moderatör tarafından incelenmeyi bekliyor olarak işaretler.
  • published – Yorumu herkese açık olarak görüntülenmek üzere temizler.
  • rejected – Görüntüleme için uygun olmadığı için yorumu reddeder. Bu işlem, reddedilen yoruma verilen tüm yanıtları da etkili şekilde gizler.
İsteğe bağlı parametreler
banAuthor boolean
banAuthor parametresi, yorumun yazarı tarafından yazılan ek yorumları otomatik olarak reddetmek istediğinizi belirtmenizi sağlar. Yazarı yasaklamak için parametre değerini true olarak ayarlayın.

Not: Bu parametre yalnızca moderationStatus parametresi de rejected olarak ayarlanmışsa geçerlidir.

İstek içeriği

Bu yöntemi çağırırken istek gövdesi sağlama.

Yanıt

Başarılı olursa bu yöntem bir HTTP 204 yanıt kodu (No Content) 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ı dokümanına bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) banWithoutReject banAuthor parametresi yalnızca moderationStatus parametre değeri rejected ise kullanılabilir.
badRequest (400) operationNotSupported Google+'ya dayalı olmayan yorumlar, yalnızca sınırlı denetim işlevi sunar.
badRequest (400) processingFailure API sunucusu isteği başarılı bir şekilde işleyemedi. Bu geçici bir hata olabilir, ancak genellikle istek girişinin geçersiz olduğunu gösterir.
forbidden (403) forbidden Bir veya daha fazla yorumun denetleme durumu, yetersiz izinler nedeniyle ayarlanamıyor. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404) commentNotFound İsteğin güncellemeye çalıştığı yorumlardan biri veya daha fazlası bulunamıyor. Doğru olduklarından emin olmak için isteğin id parametre değerlerini kontrol edin.

Deneyin.

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