Zasób comment
zawiera informacje o pojedynczym komentarzu w YouTube. Zasób comment
może reprezentować komentarz na temat filmu lub kanału. Może to być komentarz najwyższego poziomu lub odpowiedź na komentarz najwyższego poziomu.
Metody
Interfejs API obsługuje te metody zasobów comments
:
- list
- Zwraca listę komentarzy pasujących 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 - aktualizacja
- Modyfikuje komentarz. Wypróbuj teraz
- usuń
- Usuwa komentarz. Wypróbuj teraz
- setModerationStatus
- Określa stan moderowania co najmniej jednego komentarza. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub filmu powiązanego z komentarzami. Wypróbuj teraz
- markAsSpam
- Uwaga: ta metoda została wycofana i nie jest już obsługiwana.
- wyraża opinię rozmówcy, że co najmniej jeden komentarz powinien zostać oznaczony jako spam.
Reprezentacja zasobu
Poniższa struktura JSON pokazuje 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 przedstawia właściwości, które pojawiają się w tym zasobie:
Właściwości | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartością będzie youtube#comment . |
etag |
etag ETag tego zasobu. |
id |
string Identyfikator używany w YouTube do jednoznacznego zidentyfikowania 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 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 w YouTube powiązanego z komentarzem. |
snippet.textDisplay |
string Tekst komentarza. Możesz pobrać tekst w postaci zwykłego tekstu lub kodu HTML. (Obie metody comments.list i commentThreads.list obsługują parametr textFormat , który określa wybrany format tekstowy).Nawet zwykły tekst może się różnić od oryginalnego tekstu komentarza. Linki do filmów mogą na przykład zostać zastąpione tytułami filmów. |
snippet.textOriginal |
string Oryginalny, nieprzetworzony tekst komentarza w momencie jego pierwszego opublikowania lub ostatniej aktualizacji. 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 wskazuje, czy obecny widz może ocenić komentarz. |
snippet.viewerRating |
string Ocena podana przez widza dla tego komentarza. Ta właściwość nie identyfikuje ocen typu dislike , chociaż to działanie może ulec zmianie. Tymczasem wartość właściwości wynosi like , jeśli osoba przeglądająca pozytywnie oceniła komentarz. Wartość to none we wszystkich innych przypadkach. Dotyczy to również użytkownika, który przyznał komentarzowi negatywną ocenę lub nie ocenił go.Prawidłowe wartości tej właściwości to:
|
snippet.likeCount |
unsigned integer Łączna liczba polubień (ocen pozytywnych), które otrzymał komentarz. |
snippet.moderationStatus |
string Stan moderowania komentarza. Ta właściwość jest zwracana tylko wtedy, gdy żądanie do interfejsu API zostało autoryzowane przez właściciela kanału lub w przypadku filmu, pod którym znajdują się żądane komentarze. Ta właściwość jest też nieskonfigurowana, jeśli w żądaniu do interfejsu API użyto parametru filtra id .Prawidłowe wartości tej usługi to:
|
snippet.publishedAt |
datetime Data i godzina pierwotnej publikacji komentarza. Wartość należy podać w formacie ISO 8601. |
snippet.updatedAt |
datetime Data i godzina ostatniej aktualizacji komentarza. Wartość należy podać w formacie ISO 8601. |