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.