Comments: insert

Tworzy odpowiedź na istniejący komentarz. Uwaga: aby utworzyć komentarz najwyższego poziomu, użyj metody commentThreads.insert.

Wpływ na limit: wywołanie tej metody kosztuje 50 jednostek limitu.

Częste zastosowania

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/comments

Autoryzacja

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/youtube.force-ssl

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part określa właściwości, które będą uwzględnione w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet. Część snippet kosztuje 2 jednostki limitu.

Poniżej znajdziesz listę nazw part, które możesz uwzględnić w wartości parametru:
  • id
  • snippet

Treść żądania

W treści żądania podaj zasób komentarza. W przypadku tego zasobu:

  • Musisz podać wartość tych właściwości:

    • snippet.textOriginal
    • snippet.parentId

  • Możesz ustawić wartości tych właściwości:

    • snippet.textOriginal

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób komentarza.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextRequired Wstawiany zasób comment musi mieć określoną wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400) invalidCustomEmoji Wstawiany zasób comment zawiera nieprawidłowe niestandardowe emoji.
badRequest (400) invalidCommentMetadata Metadane żądania są nieprawidłowe.
badRequest (400) operationNotSupported Użytkownik interfejsu API nie może wstawić komentarza w odpowiedzi na komentarz najwyższego poziomu określony przez właściwość snippet.parentId. We właściwości snippet.canReply zasobu commentThread jest określone, czy bieżący widz może odpowiedzieć na wątek.
badRequest (400) parentCommentIsPrivate Określony komentarz nadrzędny jest prywatny. Interfejs API nie obsługuje odpowiedzi na komentarze prywatne.
badRequest (400) parentIdMissing Wstawiany komentarz musi być powiązany z komentarzem nadrzędnym. Jednak zasób comment w treści żądania do interfejsu API nie zawierał wartości właściwości snippet.parentId.
badRequest (400) processingFailure Serwer interfejsu API nie zdołał prawidłowo przetworzyć żądania. Może to być błąd przejściowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie można utworzyć komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika.
notFound (404) parentCommentNotFound Nie udało się znaleźć określonego komentarza nadrzędnego. Sprawdź wartość właściwości snippet.parentId w treści żądania, aby upewnić się, że jest prawidłowa.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.