Tạo nhận xét mới cấp cao nhất. Để thêm câu trả lời vào nhận xét hiện có, hãy sử dụng phương thức comments.insert
.
Mức tác động cho hạn mức: Một lệnh gọi đến phương thức này có chi phí định mức là 50 đơn vị.
Các trường hợp sử dụng phổ biến
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/youtube/v3/commentThreads
Ủy quyền
Yêu cầu này yêu cầu uỷ quyền có ít nhất một trong các phạm vi sau (đọc thêm về xác thực và cấp phép).
Phạm vi |
---|
https://www.googleapis.com/auth/youtube.force-ssl |
Các tham số
Bảng sau trình bày các tham số mà truy vấn này hỗ trợ. Tất cả thông số được liệt kê đều là thông số truy vấn.
Các tham số | ||
---|---|---|
Các thông số bắt buộc | ||
part |
string Thông số part xác định các thuộc tính mà phản hồi API sẽ bao gồm. Đặt giá trị thông số thành snippet . Phần snippet có chi phí định mức là 2 đơn vị.Danh sách sau đây chứa part tên mà bạn có thể đưa vào giá trị thông số:
|
Nội dung yêu cầu
Cung cấp tài nguyên commentsThread trong nội dung yêu cầu. Đối với tài nguyên đó:
-
Bạn phải chỉ định một giá trị cho các thuộc tính này:
snippet.channelId
snippet.topLevelComment.snippet.textOriginal
-
Bạn có thể đặt giá trị cho các thuộc tính sau:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
Phản hồi
Nếu thành công, phương thức này sẽ trả về một tài nguyên commentsThread trong nội dung phản hồi.
Lỗi
Bảng sau đây xác định các thông báo lỗi mà API có thể trả về khi 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 thông tin chi tiết.
Loại lỗi | Thông tin chi tiết về lỗi | Mô tả |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Mỗi chuỗi bình luận phải được liên kết với một kênh hoặc video.
|
badRequest (400) |
commentTextRequired |
Tài nguyên comment được chèn phải chỉ định một giá trị cho thuộc tính snippet.topLevelComment.snippet.textOriginal . Không được để trống nhận xét. |
badRequest (400) |
commentTextTooLong |
Tài nguyên comment đang được chèn chứa quá nhiều ký tự trong thuộc tính snippet.topLevelComment.snippet.textOriginal . |
badRequest (400) |
invalidCommentThreadMetadata |
Siêu dữ liệu về yêu cầu là không hợp lệ. |
badRequest (400) |
processingFailure |
Máy chủ API không xử lý được yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết rằng dữ liệu đầu vào của yêu cầu là không hợp lệ. Hãy kiểm tra cấu trúc của tài nguyên commentThread trong phần nội dung của yêu cầu để đảm bảo rằng tài nguyên đó hợp lệ. |
forbidden (403) |
forbidden |
Không thể tạo chuỗi nhận xét do không có đủ quyền. Có thể yêu cầu được cấp phép không đúng cách. |
forbidden (403) |
ineligibleAccount |
Tài khoản YouTube dùng để uỷ quyền cho yêu cầu API phải được hợp nhất với Tài khoản Google của người dùng để chèn một bình luận hoặc chuỗi bình luận. |
notFound (404) |
channelNotFound |
Không tìm thấy kênh đã chỉ định. Kiểm tra giá trị của thuộc tính snippet.channelId để đảm bảo rằng giá trị này chính xác. |
notFound (404) |
videoNotFound |
Không tìm thấy video đã chỉ định. Kiểm tra giá trị của thuộc tính snippet.videoId để đảm bảo rằng giá trị này chính xác. |
Hãy dùng thử!
Hãy dùng APIs Explorer để gọi API này cũng như xem yêu cầu và phản hồi của API.