CommentThreads: insert

Tworzy nowy komentarz najwyższego poziomu. Aby dodać odpowiedź do istniejącego komentarza, użyj metody comments.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/commentThreads

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

Treść żądania

W treści żądania podaj zasób commentThread.

W przypadku tego zasobu musisz określić wartość tych właściwości:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Odpowiedź

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

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) channelOrVideoIdMissing Każdy wątek komentarzy musi być powiązany z filmem. Upewnij się, że zasób określa wartości właściwości snippet.channelId i snippet.videoId. Komentarz do filmu pojawia się na stronie odtwarzania filmu.
badRequest (400) commentTextRequired Wstawiany zasób comment musi określać wartość właściwości snippet.topLevelComment.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.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Metadane żądania są nieprawidłowe.
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 commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie udało się utworzyć wątku komentarzy 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) channelNotFound Nie udało się znaleźć określonego kanału. Sprawdź wartość właściwości snippet.channelId, aby upewnić się, że jest prawidłowa.
notFound (404) videoNotFound Nie udało się znaleźć określonego filmu. Sprawdź wartość właściwości snippet.videoId, 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.