Comments

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

Metody

Interfejs API obsługuje te metody dla 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 do interfejsu 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,
    "imageUrl": string
  }
}

Właściwości

W tej tabeli znajdziesz 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
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 w YouTube autora komentarza, jeśli jest dostępny.
snippet.channelId string
Identyfikator kanału w 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, jaką widz przyznał temu komentarzowi. Ta właściwość nie identyfikuje ocen dislike, ale to zachowanie może się zmienić. W tym czasie wartość właściwości to like, jeśli widz ocenił komentarz pozytywnie. W pozostałych przypadkach wartość to none, w tym gdy użytkownik ocenił komentarz negatywnie lub nie ocenił go wcale.

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 do interfejsu 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 do 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 pierwotnej publikacji komentarza. Wartość jest podana w formacie ISO 8601.
snippet.updatedAt datetime
Data i godzina ostatniej aktualizacji komentarza. Wartość jest podana w formacie ISO 8601.
snippet.imageUrl string
Adres URL obrazu lub animowanego GIF-a dołączonego do komentarza (jeśli jest). Ta właściwość występuje tylko wtedy, gdy komentarz zawiera obraz lub GIF-a. Adres URL jest udostępniany jako podpisany link z 6-godzinnym czasem życia (TTL) i wygasa 6 godzin po pobraniu.