Videos: reportAbuse

Kötüye kullanım amaçlı içerik barındırdığı için bir videoyu bildirir.

Kota etkisi: Bu yönteme yapılan bir çağrının 50 birim kota maliyeti olur.

İstek

HTTP isteği

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

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekir (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 parametrelerin tümü sorgu parametreleridir.

Parametreler
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortaklarına yöneliktir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yaparak tüm video ve kanal verilerine erişmelerine olanak tanır. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.

İstek içeriği

İsteğin 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 özelliklerin değerlerini ayarlamanız gerekir:

İsteğe bağlı özellikler

Aşağıdaki özellikler için değerler 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
Videonun kötüye kullanım amaçlı içerik barındırması nedeniyle bildirilen videonun ikincil nedenini belirtir. İkincil neden, sakıncalı içerikle ilgili olarak reasonId özelliğinin tanımladığı birincil nedenden daha ayrıntılı bir açıklama sağlar. Değeri uygun ikincil nedenin unique ID değerine ayarlayın.
comments string
Bildiren kişinin eklemek istediği diğer bilgileri sağlar.
language object
Muhabirin konuştuğu dili tanımlar.

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 çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmıştır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) invalidAbuseReason İstek, reasonId özelliği için beklenmeyen bir değer veya reasonId ve secondaryReasonId özelliklerinin geçersiz bir kombinasyonunu içeriyordu.
badRequest (400) rateLimitExceeded Kullanıcı, belirli bir zaman aralığında çok fazla istek gönderdi.
forbidden (403) forbidden
notFound (404) videoNotFound Kötüye kullanım bildirmeye çalıştığınız video bulunamıyor.

Deneyin.

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