Videos: reportAbuse

Kötüye kullanım barındıran bir videoyu bildirme.

Kota etkisi: Bu yöntemin çağrısı 50 birim kota maliyetine sahiptir.

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/videos/reportAbuse

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az birinde yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Parametreler

Aşağıdaki tabloda bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube içerik yönetim sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulaması yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı içerik yönetim sistemi hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek içeriği

İstek gövdesi aşağıdaki veri yapısına sahiptir:

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

Zorunlu özellikler

Aşağıdaki özellikler için değerler ayarlamanız gerekir:

İsteğe bağlı özellikler

Aşağıdaki özellikler için değer ayarlayabilirsiniz:

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
videoId string
Kötüye kullanım amaçlı içerik barındırdığı için bildirilen videoyu tanımlar. Değeri, ilgili videonun YouTube video kimliğine ayarlayın.
reasonId object
Kötüye kullanım amaçlı içerik barındırdığı için bildirilen videonun nedenini belirtir. Değeri, uygun videoAbuseReportReason kaynağının unique ID değerine ayarlayın.
secondaryReasonId object
Kötüye kullanım amaçlı içerik barındırdığı için bildirilen videonun ikincil nedenini belirtir. İkincil neden, sakıncalı içeriğin reasonId mülkünün tanımladığı birincil nedenden daha ayrıntılı bir açıklamasını sağlar. Değeri, uygun ikincil nedenin unique ID değerine ayarlayın.
comments string
Bildirenin eklemek istediği ek bilgileri sağlar.
language object
Muhabirin konuştuğu dili tanımlar.

Yanıt

Bu yöntem başarılı olursa 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) invalidAbuseReason İstek, reasonId mülkü için beklenmeyen bir değer veya reasonId ve secondaryReasonId mülklerinin geçersiz bir kombinasyonunu içeriyordu.
badRequest (400) rateLimitExceeded Kullanıcı belirli bir zaman diliminde çok fazla istek göndermiştir.
forbidden (403) forbidden
notFound (404) videoNotFound Kötüye kullanım bildirmeye çalıştığınız video bulunamadı.

Deneyin!

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