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

Metody

Interfejs API obsługuje te metody dotyczące zasobów comments:

list: Zwraca listę komentarzy, które pasują do parametrów żądania interfejsu API. Wypróbuj teraz
insert: Tworzy odpowiedź na istniejący komentarz. Uwaga: aby utworzyć komentarz najwyższego poziomu, użyj metody commentThreads.insert. Wypróbuj
update: Modyfikuje komentarz. Wypróbuj teraz
usuń: Usuwanie komentarza. Wypróbuj teraz
setModerationStatus: Ustawia stan moderacji co najmniej 1 komentarza. Żądanie przesłane przez interfejs 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ę dzwoniącego, że co najmniej 1 komentarz powinien zostać oznaczony jako spam.

Reprezentacja zasobu

Struktura JSON poniżej 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

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 różnić się od oryginalnego tekstu komentarza. Może na przykład zastąpić linki do filmów ich tytułami.
`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 użytkownik może ocenić komentarz.
`snippet.viewerRating`	`string` Ocena przyznana przez widza temu komentarzowi. Ta usługa nie identyfikuje ocen `dislike`, ale może się to zmienić. Tymczasem, jeśli widz ocenił komentarz pozytywnie, wartość właściwości to `like`. We wszystkich innych przypadkach, w tym gdy użytkownik ocenił komentarz negatywnie lub nie ocenił go w ogóle, wartość to `none`. Dopuszczalne wartości tej właściwości to: `like` `none`
`snippet.likeCount`	`unsigned integer` Łączna liczba polubień (pozytywnych ocen) danego komentarza.
`snippet.moderationStatus`	`string` Stan moderacji komentarza. Ta właściwość jest zwracana tylko wtedy, gdy prośba o dostęp do interfejsu API została autoryzowana przez właściciela kanału lub filmu, do którego odnoszą się żą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 podawana w formacie ISO 8601.
`snippet.updatedAt`	`datetime` Data i godzina ostatniej aktualizacji komentarza. Wartość jest podawana w formacie ISO 8601.