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 do filmu lub kanału. Dodatkowo może to być komentarz najwyższego poziomu lub odpowiedź na komentarz najwyższego poziomu.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów comments:

list: Zwraca listę komentarzy, które pasują do parametrów żądania 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
zaktualizuj: Modyfikuje komentarz. Wypróbuj teraz
usuń: Usuwanie komentarza. Wypróbuj teraz
setModerationStatus: Ustawia stan moderacji co najmniej 1 komentarza. Żądanie do interfejsu API musi zostać 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ż dostępna jest obsługiwana.; Wyraża opinię dzwoniącego, że co najmniej 1 komentarz powinien zostać oznaczony jako spam.

Reprezentowanie zasobu

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

Właściwości występujące w tym zasobie są opisane w tabeli poniżej:

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 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 YouTube powiązanego z komentarzem.
`snippet.textDisplay`	`string` Tekst komentarza. Tekst można pobrać w formacie zwykłego tekstu lub HTML. (Metody `comments.list` i `commentThreads.list` obsługują parametr `textFormat`, który określa wybrany format tekstu). Nawet zwykły tekst może się różnić od oryginalnego tekstu komentarza. Linki do filmów mogą na przykład zastąpić tytułami filmów.
`snippet.textOriginal`	`string` Pierwotny, nieprzetworzony tekst komentarza w postaci, w której został on pierwotnie opublikowany lub ostatnio zaktualizowany. Pierwotny tekst jest zwracany tylko uwierzytelnionym użytkownikom, jeśli są oni autorami 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 bieżący widz może ocenić komentarz.
`snippet.viewerRating`	`string` Ocena przyznana przez widza temu komentarzowi. Ta właściwość nie rozpoznaje ocen aplikacji `dislike`, jednak może to ulec zmianie. Tymczasem, jeśli widz ocenił komentarz pozytywnie, wartość właściwości to `like`. We wszystkich pozostałych przypadkach wartość to `none`, nawet jeśli użytkownik przyznał komentarzowi ocenę negatywną 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) przyznanych komentarzowi.
`snippet.moderationStatus`	`string` Stan moderacji komentarza. Ta właściwość jest zwracana tylko wtedy, gdy żądanie do interfejsu API zostało zatwierdzone przez właściciela kanału lub film, do którego dodano żądane komentarze. Ta właściwość nie jest też ustawiona, jeśli żądanie interfejsu API używało parametru filtra `id`. Dopuszczalne 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 podawana w formacie ISO 8601.