CommentThreads: insert

Tworzy nowy komentarz najwyższego poziomu. Aby dodać odpowiedź do istniejącego komentarza, użyj metody comments.insert.

Wpływ limitu: wywołanie tej metody ma limit kosztów wynoszący 50 jednostek.

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z co najmniej jednym z poniższych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

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

Parametry

W poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part określa właściwości odpowiedzi interfejsu API. Ustaw wartość parametru na snippet. W części snippet obowiązuje limit 2 jednostek.

Ta lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • id
  • replies
  • snippet

Treść żądania

Podaj zasób komentarze w treści żądania. Dla tego zasobu:

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

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

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

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

Odpowiedź

Jeśli operacja się powiedzie, metoda zwróci commentThread w treści odpowiedzi.

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ć połączony z kanałem lub filmem.
  • Jeśli komentarz dotyczy kanału, sprawdź, czy zasób określony w treści żądania zawiera wartość właściwości snippet.channelId. Komentarz dotyczący kanału zostanie wyświetlony na karcie Dyskusja.
  • Jeśli komentarz dotyczy filmu, upewnij się, że zasób określa wartości we właściwościach snippet.channelId i snippet.videoId. Komentarz dotyczący filmu pojawi się na jego stronie odtwarzania.
badRequest (400) commentTextRequired Wstawiony zasób comment musi określać wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiony 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 Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest on prawidłowy.
forbidden (403) forbidden Nie udało się utworzyć wątku z komentarzem z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi zostać połączone z kontem Google użytkownika.
notFound (404) channelNotFound Nie udało się znaleźć tego kanału. Sprawdź, czy wartość właściwości snippet.channelId jest prawidłowa.
notFound (404) videoNotFound Nie udało się znaleźć podanego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa.

Wypróbuj

Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.