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
partstring
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ỗiChi tiết lỗiNội dung mô tả
badRequest (400)channelOrVideoIdMissingMỗ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)commentTextRequiredTà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)commentTextTooLongTà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)invalidCommentThreadMetadataSiêu dữ liệu của yêu cầu không hợp lệ.
badRequest (400)processingFailureMá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)forbiddenKhô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)ineligibleAccountTà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)channelNotFoundKhô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)videoNotFoundKhô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.