CommentThreads: insert

Tạo một bình luận cấp cao nhất mới. Để thêm câu trả lờ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: Mỗi lệnh gọi đến phương thức này có mức sử dụng 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

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 string
Tham số part xác định những thuộc tính mà phản hồi của API sẽ bao gồm. Đặt giá trị tham số thành snippet. Phần snippet có hạn mức sử dụng là 2 đơn vị.

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

Nội dung yêu cầu

Cung cấp một tài nguyên commentThread 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 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 commentThread 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 thông tin, hãy xem tài liệu về thông báo lỗi.

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) channelOrVideoIdMissing Mỗi chuỗi nhận xét phải được liên kết với một video. Hãy đảm bảo tài nguyên chỉ định giá trị cho các thuộc tính snippet.channelId và snippet.videoId. 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 bình luận.
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ý thành công yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết 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 tạo được chuỗi nhận xét do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đú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 bình luận hoặc chuỗi nhận xét.
notFound (404) channelNotFound Không 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 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ị đó chính xác.

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.