Ta strona została przetłumaczona przez Cloud Translation API.

Comments

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: `like` `none`
`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: `heldForReview` `likelySpam` `published` `rejected`
`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.