Comments: insert

Tạo câu trả lời cho một bình luận hiện có. Lưu ý: Để tạo bình luận cấp cao nhất, hãy sử dụng phương thức commentThreads.insert.

Tác động đến hạn mức: Một 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/comments

Ủ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 các 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ó chi phí hạn mức là 2 đơn vị.

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

Nội dung yêu cầu

Cung cấp tài nguyên bình luận 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.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 bình luậ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. Vui lòng xem tài liệu về thông báo lỗi để biết thêm chi tiết.

Loại lỗi Chi tiết lỗi Mô tả
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.textOriginal. Bình luận không được để trống.
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 yêu cầu không hợp lệ.
badRequest (400) operationNotSupported Người dùng API không thể chèn bình luận để trả lời bình luận cấp cao nhất được xác định bằng thuộc tính snippet.parentId. 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 bình luận hay không.
badRequest (400) parentCommentIsPrivate Bình luận mẹ được chỉ định là riêng tư. API không hỗ trợ trả lời nhận xét riêng tư.
badRequest (400) parentIdMissing Bình luận đang được chèn phải được liên kết với một bình luận mẹ. Tuy nhiên, tài nguyên comment trong nội dung yêu cầu API không chỉ định giá trị cho thuộc tính snippet.parentId.
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 rằng đầ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 comment 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 bình luận do không có đủ quyền. Yêu cầu có thể không đượ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 nhóm chuỗi bình luận.
notFound (404) parentCommentNotFound Không tìm thấy bình luận mẹ được 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ị đó là 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 và phản hồi.