Comments: insert

Tạo phản hồi cho một bình luận hiện có. Lưu ý: Để tạo nhận xét ở cấp cao nhất, hãy sử dụng phương thức commentThreads.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/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

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
  • snippet

Nội dung yêu cầu

Cung cấp tài nguyên nhận xét trong nội dung yêu cầu. Đối với tài nguyên đó:

  • Bạn phải chỉ định giá trị cho những thuộc tính sau:

    • snippet.textOriginal
    • snippet.parentId

  • Bạn có thể đặt giá trị cho những 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 Nội dung 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. 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.textOriginal.
badRequest (400) invalidCustomEmoji Tài nguyên comment đang được chèn có 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 của yêu cầu không hợp lệ.
badRequest (400) operationNotSupported Người dùng API không thể chèn nhận xét để phản hồi nhận xét cấp cao nhất do thuộc tính 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 chuỗi tin nhắn hay không.
badRequest (400) parentCommentIsPrivate Nhận xét mẹ được chỉ định ở chế độ riêng tư. API này không hỗ trợ 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 gốc. 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 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 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 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) parentCommentNotFound Không thể tìm thấy nhận xét 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 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.