Comments: setModerationStatus

Bir veya daha fazla yorumun moderasyon 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 kota maliyeti 50 birimdir.

Yaygın kullanım alanları

İstek

HTTP isteği

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

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
id	string id parametresi, moderasyon durumunu güncellediğiniz yorumları tanımlayan, virgülle ayrılmış ve en fazla 50 kimlikten oluşan bir liste belirtir.
moderationStatus	string Belirtilen yorumların yeni moderasyon durumunu tanımlar. Kabul edilen değerler şunlardır: heldForReview: Bir yorumu moderatör tarafından incelenmeyi bekliyor olarak işaretler. published: Bir yorumu herkese açık olarak gösterilmek üzere onaylar. Reddedilen bir yorumun denetleme durumunu published olarak değiştiremezsiniz. rejected: Bir yorumu gösterilmeye uygun olmadığı için reddeder. Bu işlem, reddedilen yoruma verilen tüm yanıtları da gizler. Başka bir kullanıcının yazdığı yorumu kanalınızdan veya videonuzdan kaldırmak için yorumun denetleme durumunu rejected olarak ayarlayın. comments.delete yöntemi yalnızca yorumun asıl yazarı tarafından kullanılabilir.
İsteğe bağlı parametreler
banAuthor	boolean banAuthor parametresi, yorumu yazan kullanıcının diğer yorumlarını otomatik olarak reddetmek istediğinizi belirtmenize olanak tanır. Yazarı yasaklamak için parametre değerini true olarak ayarlayın. Bu parametre yalnızca moderationStatus parametresi de rejected olarak ayarlanmışsa geçerlidir.

İstek metni

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

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ı belgelerine 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+ tabanlı olmayan yorumlar yalnızca sınırlı moderasyon işlevi sunar.
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. Bu hata, orijinal yorumcu tarafından silinmiş bir yorumu denetlemeye çalışırken de döndürülür.
forbidden (403)	forbidden	Yetersiz izinler nedeniyle bir veya daha fazla yorumun moderasyon durumu ayarlanamıyor. İstek yetkilendirilmemiş olabilir. Bu hata, silinmiş veya geçersiz bir yorum kimliğini denetlemeye çalışırken de döndürülür.
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 parametresinin değerlerini kontrol edin.

Deneyin.

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