Truy xuất danh sách các lý do có thể dùng để báo cáo video có hành vi sai trái.
Tác động đến hạn mức: Lệnh gọi đến phương thức này có chi phí hạn mức là 1 đơn vị.
Các trường hợp sử dụng phổ biến
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/youtube/v3/videoAbuseReportReasons
Ủy quyền
Yêu cầu này cần được uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).
| Phạm vi |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtube.readonly |
Thông số
Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả các tham số được liệt kê đều là tham số truy vấn.
| Thông số | ||
|---|---|---|
| Tham số bắt buộc | ||
part |
stringTham số part chỉ định các phần tài nguyên videoAbuseReportReason mà phản hồi của API sẽ bao gồm. Các giá trị được hỗ trợ là id và snippet. |
|
| Tham số không bắt buộc | ||
hl |
stringTham số hl chỉ định ngôn ngữ sẽ được dùng cho các giá trị văn bản trong phản hồi của API. Giá trị mặc định là en_US. |
|
Nội dung yêu cầu
Đừng cung cấp nội dung yêu cầu khi gọi phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{
"kind": "youtube#videoAbuseReportReasonListResponse",
"etag": etag,
"items": [
videoAbuseReportReason resource
]
}Thuộc tính
Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:
| Thuộc tính | |
|---|---|
kind |
stringXác định loại tài nguyên của API. Giá trị sẽ là youtube#videoAbuseReportReasonListResponse. |
etag |
etagEtag của tài nguyên này. |
items[] |
listDanh sách các tài nguyên videoAbuseReportReason. Mỗi tài nguyên xác định một lý do khiến video có thể bị báo cáo vì chứa nội dung vi phạm. Sử dụng thông tin này khi gọi phương thức videos.reportAbuse để báo cáo video có chứa nội dung vi phạm. |
Lỗi
Bảng sau đây xác định các thông báo lỗi mà API có thể trả về để phản hồi một lệnh gọi đến phương thức này. Vui lòng xem tài liệu về thông báo lỗi để biết thêm chi tiết.
| Loại lỗi | Thông tin chi tiết về lỗi | Mô tả |
|---|---|---|
forbidden (403) |
forbidden |
Hãy dùng thử!
Sử dụng APIs Explorer để gọi API này và xem Yêu cầu API cũng như phản hồi của API.