CommentThreads: insert

Tạo một nhận xét mới ở cấp cao nhất. Để thêm phản hồi cho một bình luận hiện có, hãy sử dụng phương thức comments.insert.

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à 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 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.force-ssl

Tham số

Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả tham số được liệt kê đều là tham số truy vấn.

Tham số
Tham số bắt buộc
part string
Tham số part xác định các thuộc tính sẽ có trong phản hồi API. Đặt giá trị tham số thành snippet. Phần snippet có chi phí hạn mức là 2 đơn vị.

Danh sách sau đây chứa tên part mà bạn có thể đưa vào giá trị thông số:
  • id
  • replies
  • snippet

Nội dung yêu cầu

Cung cấp commentThread resource (tài nguyên commentThread) 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 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 commentThread tài nguyên 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ề để phản hồi lệnh gọi đến phương thức này. Để biết thêm chi tiết, hãy xem tài liệu về thông báo lỗi.

Loại lỗi Chi tiết lỗi Nội dung mô tả
badRequest (400) channelOrVideoIdMissing Mỗi chuỗi bình luận phải được liên kết với một video. Đảm bảo tài nguyên này chỉ định giá trị cho các thuộc tính snippet.channelId và snippet.videoId. Một bình luận về một video sẽ xuất hiện trên trang xem của video đó.
badRequest (400) commentTextRequired Tài nguyên comment đang đượ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 phần 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 của yêu cầu 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 lỗi này thường cho biết rằng thông tin đầu vào của yêu cầu không hợp lệ. Kiểm tra cấu trúc của tài nguyên commentThread trong nội dung 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 bình luận vì không có đủ quyền. Yêu cầu có thể không được uỷ quyền đúng.
forbidden (403) ineligibleAccount Tài khoản YouTube dùng để cấp 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 bình luận hoặc chuỗi bình luận.
notFound (404) channelNotFound Không thể tìm thấy kênh được chỉ định. Kiểm tra giá trị của thuộc tính snippet.channelId để đảm bảo giá trị đó là chính xác.
notFound (404) videoNotFound Không thể tìm thấy video được chỉ định. Kiểm tra giá trị của thuộc tính snippet.videoId để đảm bảo giá trị đó là chính xác.

Hãy dùng thử!

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.