Comments

comment zawiera informacje o pojedynczym komentarzu w YouTube. Zasób comment może reprezentować komentarz dotyczący filmu lub kanału. Komentarz może być komentarzem najwyższego poziomu lub odpowiedzią na taki komentarz.

Metody

Interfejs API obsługuje te metody w przypadku zasobów comments:

list

Zwraca listę komentarzy, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz

wstaw

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

aktualizować

Modyfikuje komentarz. Wypróbuj teraz

usuń

Usuwa komentarz. Wypróbuj teraz

setModerationStatus

Ustawia stan moderowania co najmniej 1 komentarza. Żądanie API musi być autoryzowane przez właściciela kanału lub filmu powiązanego z komentarzami. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia format zasobu comments:

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

Właściwości

Poniższa tabela zawiera definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#comment.
etag	etag Tag ETag tego zasobu.
id	string Identyfikator używany przez YouTube do jednoznacznej identyfikacji komentarza.
snippet	object Obiekt snippet zawiera podstawowe informacje o komentarzu.
snippet.authorDisplayName	string Wyświetlana nazwa użytkownika, który opublikował komentarz.
snippet.authorProfileImageUrl	string Adres URL awatara użytkownika, który opublikował komentarz.
snippet.authorChannelUrl	string Adres URL kanału YouTube autora komentarza, jeśli jest dostępny.
snippet.authorChannelId	object Ten obiekt zawiera informacje o kanale w YouTube autora komentarza, jeśli są dostępne.
snippet.authorChannelId.value	string Identyfikator kanału YouTube autora komentarza, jeśli jest dostępny.
snippet.channelId	string Identyfikator kanału YouTube powiązanego z komentarzem.
snippet.textDisplay	string Tekst komentarza. Tekst można pobrać w formacie zwykłego tekstu lub HTML. (Obie metody, comments.list i commentThreads.list, obsługują parametr textFormat, który określa wybrany format tekstu). Nawet zwykły tekst może różnić się od oryginalnego tekstu komentarza. Może na przykład zastąpić linki do filmów ich tytułami.
snippet.textOriginal	string Oryginalny, nieprzetworzony tekst komentarza w formie, w jakiej został pierwotnie opublikowany lub ostatnio zaktualizowany. Oryginalny tekst jest zwracany uwierzytelnionemu użytkownikowi tylko wtedy, gdy jest on autorem komentarza.
snippet.parentId	string Unikalny identyfikator komentarza nadrzędnego. Ta właściwość jest ustawiana tylko wtedy, gdy komentarz został przesłany jako odpowiedź na inny komentarz.
snippet.canRate	boolean To ustawienie określa, czy bieżący widz może ocenić komentarz.
snippet.viewerRating	string Ocena przyznana przez widza temu komentarzowi. Ta właściwość nie identyfikuje ocen dislike, ale to zachowanie może ulec zmianie. W międzyczasie wartość właściwości to like, jeśli widz ocenił komentarz pozytywnie. W pozostałych przypadkach, w tym gdy użytkownik ocenił komentarz negatywnie lub nie ocenił go wcale, wartość to none. Prawidłowe wartości tej właściwości to: like none
snippet.likeCount	unsigned integer Łączna liczba polubień (pozytywnych ocen) otrzymanych przez komentarz.
snippet.moderationStatus	string Stan moderacji komentarza. Ta właściwość jest zwracana tylko wtedy, gdy żądanie API zostało autoryzowane przez właściciela kanału lub filmu, w którym dodano żądane komentarze. Ta właściwość nie jest też ustawiana, jeśli w żądaniu interfejsu API użyto parametru filtra id. Prawidłowe wartości tej właściwości to: heldForReview likelySpam published rejected
snippet.publishedAt	datetime Data i godzina pierwotnego opublikowania komentarza. Wartość jest podana w formacie ISO 8601.
snippet.updatedAt	datetime Data i godzina ostatniej aktualizacji komentarza. Wartość jest podana w formacie ISO 8601.