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. Komentarz może też być komentarzem najwyższego poziomu lub odpowiedzią na komentarz najwyższego poziomu.

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
aktualizacja: Modyfikuje komentarz. Wypróbuj teraz
usuń: Usuwa komentarz. Wypróbuj teraz
setModerationStatus: Określa stan moderacji 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ę osoby dzwoniącej o tym, ż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 definiuje właściwości, które pojawiają się w tym zasobie:

Właściwości
`kind`	`string` Określa typ zasobu API. Wartością będzie `youtube#comment`.
`etag`	`etag` Tag ETag tego zasobu.
`id`	`string` Identyfikator, którego YouTube używa 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 YouTube autora komentarza (jeśli jest dostępny).
`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. Jeśli komentarz jest komentarzem do kanału, ta właściwość określa kanał, którego dotyczy ten komentarz.
`snippet.textDisplay`	`string` Tekst komentarza. Tekst można pobrać w postaci zwykłego tekstu lub w formacie HTML. (Metody `comments.list` i `commentThreads.list` obsługują parametr `textFormat`, który określa odpowiedni format tekstu). Pamiętaj, że nawet zwykły tekst może się różnić od oryginalnego tekstu komentarza. Może na przykład zastąpić linki do filmów tytułami.
`snippet.textOriginal`	`string` Oryginalny, nieprzetworzony tekst komentarza w chwili jego opublikowania lub ostatniej aktualizacji. Oryginalny tekst jest zwracany tylko wtedy, gdy jest dostępny dla uwierzytelnionego użytkownika, co jest gwarantowane tylko wtedy, gdy to on jest 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 aktualny użytkownik może ocenić komentarz.
`snippet.viewerRating`	`string` Ocena, którą widz przyznał temu komentarzowi. Pamiętaj, że ta usługa nie identyfikuje obecnie ocen `dislike`, ale to działanie może ulec zmianie. Tymczasem wartość właściwości to `like`, jeśli osoba przeglądająca pozytywnie oceniła komentarz. Wartość to `none` we wszystkich innych przypadkach, również w przypadku, gdy użytkownik przyznał komentarzowi negatywną ocenę lub nie ocenił komentarza. 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 w przypadku filmu, do którego dodano żądane komentarze. Pamiętaj też, że ta właściwość nie jest ustawiona, 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ść musi być podana w formacie ISO 8601.
`snippet.updatedAt`	`datetime` Data i godzina ostatniej aktualizacji komentarza. Wartość musi być podana w formacie ISO 8601.