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 ma koszt limitu wynoszący 50 jednostek.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

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 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, które będzie zawierać odpowiedź interfejsu API. Ustaw wartość parametru na snippet. Dla części snippet obowiązuje limit wynoszący 2 jednostki.

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

Treść żądania

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

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

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób komentarza 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextRequired Wstawiane zasób comment musi określać wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiane zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400) invalidCustomEmoji Wstawiane zasób comment zawiera nieprawidłowe niestandardowe emotikony.
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 zdefiniowany przez właściwość snippet.parentId. W zasobie commentThread właściwość snippet.canReply wskazuje, czy bieżąca osoba przeglądająca może odpowiedzieć w wątku.
badRequest (400) parentCommentIsPrivate Podany komentarz nadrzędny jest prywatny. Interfejs API nie obsługuje odpowiedzi na komentarze prywatne.
badRequest (400) parentIdMissing Wstawiony komentarz musi być powiązany z komentarzem nadrzędnym. Zasób comment w treści żądania API nie określał jednak wartości dla właściwości snippet.parentId.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, 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ć poprawnie autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarza, konto YouTube używane do autoryzacji żądania do interfejsu API musi być scalone z kontem Google użytkownika.
notFound (404) parentCommentNotFound Nie udało się znaleźć podanego komentarza nadrzędnego. Sprawdź, czy wartość właściwości snippet.parentId w treści żądania jest prawidłowa.

Wypróbuj

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