Tạo câu trả lời cho nhận xét hiện có. Lưu ý: Để tạo một nhận xét cấp cao nhất, hãy sử dụng phương thức commentThreads.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/comments
Ủ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 nhận xét trong phần 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.textOriginal
snippet.parentId
-
Bạn có thể đặt giá trị cho các thuộc tính sau:
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 nhận xét 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) |
commentTextRequired |
Tài nguyên comment được chèn phải chỉ định một giá trị cho thuộc tính 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.textOriginal . |
badRequest (400) |
invalidCustomEmoji |
Tài nguyên comment đang được chèn chứa biểu tượng cảm xúc tuỳ chỉnh không hợp lệ. |
badRequest (400) |
invalidCommentMetadata |
Siêu dữ liệu về yêu cầu là không hợp lệ. |
badRequest (400) |
operationNotSupported |
Người dùng API không thể chèn một bình luận để phản hồi bình luận cấp cao nhất mà tài sản snippet.parentId xác định. Trong tài nguyên commentThread , thuộc tính snippet.canReply cho biết liệu người xem hiện tại có thể trả lời luồng hay không. |
badRequest (400) |
parentCommentIsPrivate |
Nhận xét của cha mẹ được chỉ định là riêng tư. API không hỗ trợ việc trả lời nhận xét riêng tư. |
badRequest (400) |
parentIdMissing |
Nhận xét đang được chèn phải được liên kết với nhận xét của cha mẹ. Tuy nhiên, tài nguyên comment trong phần nội dung của yêu cầu API chưa chỉ định giá trị cho thuộc tính snippet.parentId . |
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 comment 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 nhận xét do không đủ 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) |
parentCommentNotFound |
Không tìm thấy nhận xét chính đã chỉ định. Kiểm tra giá trị của thuộc tính snippet.parentId trong nội dung yêu cầu để đảm bảo rằng giá trị này là 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.