Comments: insert

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ố:
  • id
  • snippet

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.