Videos

Zasób video reprezentuje film na YouTube.

Metody

Interfejs API obsługuje te metody dla zasobów videos:

getRating
Pobiera oceny, które autoryzowany użytkownik przyznał filmom z listy. Wypróbuj teraz
list
Zwraca listę filmów, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
batchGetStats
Pobiera listę statystyk filmów, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
insert
Przesyła film do YouTube i opcjonalnie ustawia jego metadane.
aktualizować,
Aktualizuje metadane filmu. Wypróbuj teraz
usuń
Usuwa film na YouTube. Wypróbuj teraz
rate
Dodaj ocenę pozytywną lub negatywną do filmu albo usuń ocenę z filmu. Wypróbuj teraz
reportAbuse
Zgłaszanie filmu zawierającego nieodpowiednie treści. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON pokazuje format zasobu videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Właściwości

W tabeli poniżej opisano właściwości, które występują w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#video.
etag etag
Tag Etag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu.
snippet object
Obiekt snippet zawiera podstawowe informacje o filmie, takie jak tytuł, opis i kategoria.
snippet.publishedAt datetime
Data i godzina opublikowania filmu. Może się on różnić od czasu przesłania filmu. Jeśli na przykład film został przesłany jako prywatny, a później został ustawiony jako publiczny, ta właściwość będzie określać czas, kiedy film został ustawiony jako publiczny.

Istnieje kilka wyjątków:
  • Jeśli film został przesłany jako prywatny, a właściciel kanału pobrał jego metadane, wartość właściwości określa datę i godzinę przesłania filmu.
  • Jeśli film został przesłany jako niepubliczny, wartość właściwości określa też datę i godzinę przesłania filmu. W tym przypadku każdy, kto zna unikalny identyfikator filmu, może pobrać jego metadane.
  • Jeśli film został przesłany jako film tylko dla wspierających, wartość właściwości określa datę i godzinę przesłania filmu.
Wartość jest podana w formacie ISO 8601.
snippet.channelId string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału, na który został przesłany film. Ta wartość może się zmieniać, np. gdy film zostanie przypisany do innego kanału (np. kanału tematycznego lub kanału wykonawcy).
snippet.title string
Tytuł filmu. Wartość właściwości może mieć maksymalnie 100 znaków i zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >. Musisz ustawić wartość tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video.
snippet.description string
Opis filmu. Wartość właściwości może mieć maksymalnie 5000 bajtów i może zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >.

Możesz utworzyć rozdziały filmu, dodając sformatowane sygnatury czasowe (np. 00:00) w tekście opisu.
snippet.thumbnails object
Mapa miniatur powiązanych z filmem. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością – obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key) object
Prawidłowe wartości klucza:
  • default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
  • medium – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) ten obraz ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
  • standard – wersja miniatury o jeszcze wyższej rozdzielczości niż obraz o rozdzielczości high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, takich jak elementy playlisty lub wyniki wyszukiwania. Ten obraz ma 640 pikseli szerokości i 480 pikseli wysokości.
  • maxres – wersja miniatury w wysokiej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, takich jak elementy playlisty lub wyniki wyszukiwania. Ten obraz ma 1280 pikseli szerokości i 720 pikseli wysokości.
  • fhd – wersja miniatury w pełnej rozdzielczości HD (1080p). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma szerokość 1920 pikseli i wysokość 1080 pikseli.
  • qhd – miniatura w rozdzielczości Quad HD (1440p / 2K). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma szerokość 2560 pikseli i wysokość 1440 pikseli.
  • uhd – wersja miniatury w ultrawysokiej rozdzielczości (4K). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma 3840 pikseli szerokości i 2160 pikseli wysokości.
snippet.thumbnails.(key).url string
Adres URL obrazu.
snippet.thumbnails.(key).width unsigned integer
Szerokość obrazu.
snippet.thumbnails.(key).height unsigned integer
Wysokość obrazu.
snippet.channelTitle string
Tytuł kanału, do którego należy film.
snippet.tags[] list
Lista tagów słów kluczowych powiązanych z filmem. Tagi mogą zawierać spacje. Wartość właściwości może mieć maksymalnie 500 znaków. Pamiętaj o tych regułach dotyczących sposobu obliczania limitu znaków:
  • Wartość właściwości jest listą, a przecinki między elementami listy są wliczane do limitu.
  • Jeśli tag zawiera spację, serwer interfejsu API traktuje wartość tagu tak, jakby była ujęta w cudzysłów, a cudzysłów wlicza się do limitu znaków. Dlatego w przypadku limitu znaków tag Foo-Baz zawiera 7 znaków, a tag Foo Baz – 9 znaków.
snippet.categoryId string
Kategoria filmu w YouTube powiązana z filmem. Musisz ustawić wartość tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video.
snippet.liveBroadcastContent string

Wskazuje, czy film jest nadchodzącą lub aktywną transmisją na żywo. Jeśli film nie jest nadchodzącą lub aktywną transmisją na żywo, wartość to none.



Prawidłowe wartości tej właściwości to:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Język tekstu we właściwościach snippet.title i snippet.description zasobu video.
snippet.localized object
Obiekt snippet.localized zawiera zlokalizowany tytuł i opis filmu lub tytuł w języku domyślnym metadanych filmu.
  • Zlokalizowany tekst jest zwracany we fragmencie zasobu, jeśli w żądaniu videos.list użyto parametru hl, aby określić język, w którym ma być zwrócony zlokalizowany tekst, oraz jeśli zlokalizowany tekst jest dostępny w tym języku.
  • Metadane dla języka domyślnego są zwracane, jeśli nie określono wartości parametru hl lub jeśli określono wartość, ale zlokalizowane metadane nie są dostępne dla określonego języka.
Usługa zawiera wartość tylko do odczytu. Użyj obiektu localizations, aby dodać, zaktualizować lub usunąć zlokalizowane tytuły.
snippet.localized.title string
Zlokalizowany tytuł filmu.
snippet.localized.description string
Zlokalizowany opis filmu.
snippet.defaultAudioLanguage string
Właściwość default_audio_language określa język używany w domyślnej ścieżce dźwiękowej filmu.
contentDetails object
Obiekt contentDetails zawiera informacje o treściach wideo, w tym długość filmu i informację o tym, czy są dostępne napisy.
contentDetails.duration string
Długość filmu. Wartość właściwości to czas trwania w formacie ISO 8601. Na przykład w przypadku filmu, który trwa co najmniej 1 minutę i krócej niż 1 godzinę, czas trwania jest podawany w formacie PT#M#S, gdzie litery PT wskazują, że wartość określa okres, a litery M i S odnoszą się odpowiednio do długości w minutach i sekundach. Znaki # poprzedzające litery M i S to liczby całkowite określające liczbę minut (lub sekund) filmu. Na przykład wartość PT15M33S wskazuje, że film trwa 15 minut i 33 sekundy.

Jeśli film trwa co najmniej godzinę, czas trwania jest podany w formacie PT#H#M#S, w którym # przed literą H określa długość filmu w godzinach, a wszystkie inne szczegóły są takie same jak opisane powyżej. Jeśli film trwa co najmniej 1 dzień, litery P i T są rozdzielone, a format wartości to P#DT#H#M#S. Szczegółowe informacje znajdziesz w specyfikacji ISO 8601.
contentDetails.dimension string
Wskazuje, czy film jest dostępny w formacie 3D czy 2D.
contentDetails.definition string
Określa, czy film jest dostępny w wysokiej rozdzielczości (HD), czy tylko w standardowej rozdzielczości.

Prawidłowe wartości tej właściwości to:
  • hd
  • sd
contentDetails.caption string
Wskazuje, czy do filmu są dostępne napisy.

Prawidłowe wartości tej właściwości to:
  • false
  • true
contentDetails.licensedContent boolean
Wskazuje, czy film zawiera treści licencjonowane, co oznacza, że zostały one przesłane na kanał powiązany z partnerem YouTube ds. treści, a następnie objęte roszczeniem przez tego partnera.
contentDetails.regionRestriction object
Obiekt regionRestriction zawiera informacje o krajach, w których film jest (lub nie jest) widoczny. Obiekt będzie zawierać właściwość contentDetails.regionRestriction.allowed lub contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Lista kodów regionów, które identyfikują kraje, w których film jest widoczny. Jeśli ta właściwość jest obecna, a kraj nie jest wymieniony w jej wartości, film nie będzie wyświetlany w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest blokowany we wszystkich krajach.
contentDetails.regionRestriction.blocked[] list
Lista kodów regionów, które identyfikują kraje, w których film jest zablokowany. Jeśli ta właściwość jest obecna, a kraj nie jest wymieniony w jej wartości, film jest dostępny w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film można wyświetlać we wszystkich krajach.
contentDetails.contentRating object
Określa oceny, jakie film otrzymał w różnych systemach oceniania.
contentDetails.contentRating.acbRating string
Ocena filmu według Australian Classification Board (ACB) lub Australian Communications and Media Authority (ACMA). Oceny ACMA są używane do klasyfikowania programów telewizyjnych dla dzieci.

Prawidłowe wartości tej właściwości to:
  • acbC – programy, które otrzymały klasyfikację C od Australian Communications and Media Authority. Te programy są przeznaczone dla dzieci (powyżej wieku przedszkolnego), które nie ukończyły 14 lat.
  • acbE – E
  • acbG – G
  • acbM – mln
  • acbMa15plus – MA15+
  • acbP – programy, które otrzymały klasyfikację P od Australian Communications and Media Authority. Te programy są przeznaczone dla dzieci w wieku przedszkolnym.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Ocena filmu według włoskiego urzędu Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Prawidłowe wartości tej właściwości:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Ocena filmu według Anatel (Asociación Nacional de Televisión) dla telewizji chilijskiej.

Prawidłowe wartości tej właściwości to:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Ocena filmu według British Board of Film Classification (BBFC).

Prawidłowe wartości tej właściwości:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Ocena filmu przyznana przez tajlandzką Radę ds. Cenzury Filmów i Wideo.

Prawidłowe wartości tej właściwości:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Ocena filmu przyznana przez austriacką Radę ds. Klasyfikacji Mediów (Bundesministerium für Unterricht, Kunst und Kultur).

Prawidłowe wartości tej właściwości to:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – bez ograniczeń
  • bmukkUnrated
contentDetails.contentRating.catvRating string
System ocen kanadyjskiej telewizji – kanadyjski system klasyfikacji telewizyjnej Ocena filmu przyznana przez Kanadyjską Komisję ds. Radia, Telewizji i Telekomunikacji (CRTC) w przypadku kanadyjskich programów nadawanych w języku angielskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council.

Prawidłowe wartości tej właściwości:
  • catv14plus – od 14 lat
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Ocena filmu przyznana przez Canadian Radio-Television and Telecommunications Commission (CRTC) w przypadku francuskojęzycznych transmisji w Kanadzie. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council.

Prawidłowe wartości tej właściwości:
  • catvfr13plus – od 13 lat
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Ocena filmu według Central Board of Film Certification (CBFC – Indie).

Prawidłowe wartości tej właściwości:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Ocena filmu przyznana przez Consejo de Calificación Cinematográfica (Chile).

Prawidłowe wartości tej właściwości to:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Ocena filmu przyznana przez portugalską komisję Comissão de Classificação de Espect´culos.

Prawidłowe wartości tej właściwości to:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Ocena filmu w Szwajcarii.

Prawidłowe wartości tej właściwości:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Ocena filmu według kanadyjskiego systemu oceniania filmów domowych (CHVRS).

Prawidłowe wartości tej właściwości:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Ocena filmu według Commission de Contrôle des Films (Belgia).

Prawidłowe wartości tej właściwości:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Ocena filmu przyznana przez rumuńską organizację CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).

Prawidłowe wartości tej właściwości:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
System ocen we Francji – Commission de classification cinematographique

Prawidłowe wartości tej właściwości to:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Ocena filmu przyznana przez francuską instytucję Conseil supérieur de l'audiovisuel, która ocenia treści nadawane w telewizji.

Prawidłowe wartości tej właściwości to:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – zakaz
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Ocena filmu przyznana przez luksemburską Commission de surveillance de la classification des films (CSCF).

Prawidłowe wartości tej właściwości to:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Ocena filmu w Czechach.

Prawidłowe wartości tego atrybutu to:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Ocena filmu według Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brazylia).

Prawidłowe wartości tej właściwości to:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Powody, dla których film otrzymał ocenę DJCQT (Brazylia).
contentDetails.contentRating.ecbmctRating string
System ocen w Turcji – Rada ds. Oceny i Klasyfikacji Ministerstwa Kultury i Turystyki

Prawidłowe wartości tej właściwości:
  • ecbmct13a – 13A
  • ecbmct13plus – od 13 lat
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
Ocena filmu w Estonii.

Prawidłowe wartości tej właściwości:
  • eefilmK12 – szkoły podstawowe i średnie
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Ocena filmu w Egipcie.

Prawidłowe wartości tej właściwości:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Ocena filmu według systemu Eirin (映倫). Eirin to japoński system ocen.

Prawidłowe wartości tej właściwości to:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Ocena filmu przyznana przez malezyjską radę cenzury filmowej.

Prawidłowe wartości tej właściwości:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Ocena filmu wystawiona przez hongkoński urząd ds. filmu, prasy i artykułów (Office for Film, Newspaper and Article Administration).

Prawidłowe wartości tej właściwości:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Ta właściwość została wycofana 2 listopada 2015 r. Zamiast tego użyj właściwości contentDetails.contentRating.cncRating.

Ocena filmu według Centre national du cinéma et de l'image animé (francuskiego Ministerstwa Kultury).

Prawidłowe wartości tej właściwości:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Ocena filmu przyznana przez południowoafrykańską organizację Film and Publication Board.

Prawidłowe wartości tej właściwości:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Przyczyny, dla których film otrzymał ocenę FPB (RPA).
contentDetails.contentRating.fskRating string
Ocena filmu przyznana przez Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Niemcy).

Prawidłowe wartości tej właściwości to:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Ocena filmu w Grecji.

Prawidłowe wartości tego atrybutu to:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – szkoły podstawowe i średnie
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Ocena filmu według Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Hiszpania).

Prawidłowe wartości tej właściwości:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Ocena filmu przyznana przez Irish Film Classification Office (IFCO – Irlandia). Więcej informacji znajdziesz na stronie IFCO.

Prawidłowe wartości tej właściwości:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15 A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Ocena filmu w Izraelu.

Prawidłowe wartości tego atrybutu to:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Ocena filmu według INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentyna).

Prawidłowe wartości tej właściwości:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Tylko dla osób powyżej 18 roku życia)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Ocena filmu wystawiona przez Kenya Film Classification Board.

Prawidłowe wartości tej właściwości:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Netherlands).

Prawidłowe wartości tej właściwości to:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Ocena filmu według Koreańskiej Rady ds. Oceny Mediów (영상물등급위원회). KMRB ocenia filmy w Korei Południowej.

Prawidłowe wartości tej właściwości to:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Ocena filmu według indonezyjskiej organizacji Lembaga Sensor Film.

Prawidłowe wartości tej właściwości:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Ocena filmu przyznana przez maltańską Radę ds. Klasyfikacji Wiekowej Filmów.

Prawidłowe wartości tej właściwości to:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 – ta ocena została usunięta z nowej struktury klasyfikacji wprowadzonej w 2013 roku.
  • mccaa15 – 15
  • mccaa16 – 16 – ta ocena została usunięta z nowej struktury klasyfikacji wprowadzonej w 2013 roku.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Ocena filmu przyznana przez Radę ds. Mediów dla Dzieci i Młodzieży Duńskiego Instytutu Filmowego (Det Danske Filminstitut).

Prawidłowe wartości tej właściwości:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
System oceniania filmów w Wietnamie – MCST

Prawidłowe wartości tego atrybutu to:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Ocena filmu według singapurskiego urzędu Media Development Authority (MDA), a konkretnie Board of Film Censors (BFC).

Prawidłowe wartości tej właściwości:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Ocena filmu przyznana przez Medietilsynet, norweski organ ds. mediów.

Prawidłowe wartości tej właściwości to:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Ocena filmu przyznana przez fiński Kansallinen Audiovisuaalinen Instituutti (Narodowy Instytut Audiowizualny).

Prawidłowe wartości tej właściwości to:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Ocena filmu przyznana przez Ministero dei Beni e delle Attività Culturali e del Turismo (Włochy).

Prawidłowe wartości tej właściwości to:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Ocena filmu według Ministerio de Cultura (Kolumbia).

Prawidłowe wartości tej właściwości:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – zablokowany
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Ocena filmu przyznana przez Ministerstwo Kultury Tajwanu (文化部).

Prawidłowe wartości tej właściwości to:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Ocena filmu przyznana przez Motion Picture Association of America (MPAA).

Prawidłowe wartości tej właściwości to:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Ocena Motion Picture Association of America dla zwiastunów i zapowiedzi filmów.

Prawidłowe wartości tej właściwości:
  • mpaatGb – GB (Green Band – Approved for all audiences)
  • mpaatRb – RB (Red Band – zalecane dla osób w wieku 17 lat i starszych)
contentDetails.contentRating.mtrcbRating string
Ocena filmu według Movie and Television Review and Classification Board (Filipiny).

Prawidłowe wartości tej właściwości:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Ocena filmu przyznana przez malediwskie Krajowe Biuro Klasyfikacji.

Prawidłowe wartości tego atrybutu to:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Ocena filmu przyznana przez Bulgarian National Film Center.

Prawidłowe wartości tej właściwości:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Ocena filmu przyznana przez nigeryjską organizację National Film and Video Censors Board.

Prawidłowe wartości tej właściwości to:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Ocena filmu przyznana przez Nacionãlais Kino centrs (Narodowe Centrum Filmowe Łotwy).

Prawidłowe wartości tej właściwości to:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Ocena filmu przyznana przez nowozelandzki urząd ds. klasyfikacji filmów i literatury (OFLC).

Prawidłowe wartości tej właściwości:
  • oflcG – G
  • oflcM – mln
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Ocena filmu w Peru.

Prawidłowe wartości tej właściwości:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Ocena filmu w Wenezueli.

Prawidłowe wartości tej właściwości:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Ocena filmu przyznana przez Generalną Dyrekcję ds. Radia, Telewizji i Kinematografii (Meksyk).

Prawidłowe wartości tej właściwości to:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Ocena filmu przyznana przez irlandzką stację Raidió Teilifís Éireann.

Prawidłowe wartości tego atrybutu:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Ocena filmu w rejestrze filmów Narodowego Funduszu Filmowego Federacji Rosyjskiej (MKRF – Rosja).

Prawidłowe wartości tej właściwości to:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Ocena filmu na Słowacji.

Prawidłowe wartości tej właściwości:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Ocena filmu w Islandii.

Prawidłowe wartości tej właściwości:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Ocena filmu według Statens medieråd (Szwedzkiej Krajowej Rady ds. Mediów).

Prawidłowe wartości tej właściwości:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – Wszystkie grupy wiekowe
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Ocena filmu według systemu TV Parental Guidelines (TVPG).

Prawidłowe wartości tej właściwości:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Ocena, której YouTube używa do identyfikowania treści z ograniczeniem wiekowym.

Prawidłowe wartości tej właściwości to:
  • ytAgeRestricted
contentDetails.projection string
Określa format projekcji filmu.

Prawidłowe wartości tej właściwości to:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Wskazuje, czy osoba, która przesłała film, dodała do niego niestandardową miniaturę. Ta właściwość jest widoczna tylko dla osoby, która przesyła film.
status object
Obiekt status zawiera informacje o stanie przesyłania, przetwarzania i prywatności filmu.
status.uploadStatus string
Stan przesłanego filmu.

Prawidłowe wartości tego atrybutu to:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Ta wartość wyjaśnia, dlaczego nie udało się przesłać filmu. Ta właściwość występuje tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesyłanie nie powiodło się.

Prawidłowe wartości tej właściwości to:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Ta wartość wyjaśnia, dlaczego YouTube odrzucił przesłany film. Ta właściwość występuje tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesłanie zostało odrzucone.

Prawidłowe wartości tej właściwości to:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Stan prywatności filmu. Jeśli w żądaniu videos.insert nie określisz wartości tej właściwości, stan prywatności przesłanego filmu będzie domyślnie ustawiony na public. Niektóre przesłane treści mogą domyślnie mieć ustawienie private na podstawie ustawień konta twórcy, jak wyjaśniono w Centrum pomocy YouTube. Filmy przesłane z niezweryfikowanych projektów interfejsu API nie są ograniczone do trybu wyświetlania prywatnego.

Prawidłowe wartości tej właściwości:
  • private
  • public
  • unlisted
status.publishAt datetime
Data i godzina zaplanowanej publikacji filmu. Można go ustawić tylko wtedy, gdy stan prywatności filmu jest ustawiony jako prywatny. Wartość jest podana w formacie ISO 8601. Zwróć uwagę na te 2 dodatkowe kwestie dotyczące działania tej właściwości:
  • Jeśli ustawisz wartość tej właściwości podczas wywoływania metody videos.update, musisz też ustawić wartość właściwości status.privacyStatus na private, nawet jeśli film jest już prywatny.
  • Tę właściwość można ustawić tylko wtedy, gdy stan prywatności filmu to private i film nie został jeszcze opublikowany.
  • Jeśli w żądaniu zaplanujesz publikację filmu na czas, który już minął, film zostanie opublikowany od razu. W związku z tym ustawienie właściwości status.publishAt na datę i godzinę z przeszłości ma taki sam skutek jak zmiana właściwości privacyStatus filmu z private na public.
status.license string
Licencja filmu.

Prawidłowe wartości tej właściwości to:
  • creativeCommon
  • youtube
status.embeddable boolean
Ta wartość wskazuje, czy film może być umieszczany w innych witrynach.
status.publicStatsViewable boolean
Ta wartość wskazuje, czy rozszerzone statystyki filmu na stronie odtwarzania są widoczne publicznie. Domyślnie te statystyki są widoczne, a statystyki takie jak liczba wyświetleń filmu i oceny będą nadal widoczne publicznie, nawet jeśli wartość tej właściwości jest ustawiona na false.
status.madeForKids boolean
Ta wartość wskazuje, czy film jest przeznaczony dla dzieci, i zawiera aktualny stan filmu w zakresie „przeznaczony dla dzieci”. Na przykład stan może być określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o określaniu odbiorców kanału, filmów lub transmisji znajdziesz w Centrum pomocy YouTube.
status.selfDeclaredMadeForKids boolean
W żądaniu videos.insert lub videos.update ta właściwość pozwala właścicielowi kanału oznaczyć film jako przeznaczony dla dzieci. W żądaniu videos.list wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie do interfejsu API.
status.containsSyntheticMedia boolean
W przypadku żądania videos.insert lub videos.update ta właściwość umożliwia właścicielowi kanału ujawnienie, że film zawiera realistyczne treści zmodyfikowane lub wygenerowane syntetycznie (A/S). Dowiedz się więcej o zasadach YouTube dotyczących treści dla dorosłych.

Przykłady treści o charakterze seksualnym lub sugestywnym obejmują filmy, które:
  • Utworzenie treści przedstawiających prawdziwą osobę, która mówi lub robi coś, czego wcale nie powiedziała ani nie zrobiła.
  • Zmodyfikowanie materiału pokazującego prawdziwe wydarzenie lub miejsce
  • Wygenerowanie realistycznie wyglądającej sceny, która faktycznie nie miała miejsca
statistics object
Obiekt statistics zawiera statystyki dotyczące filmu.
statistics.viewCount unsigned long

Liczba wyświetleń filmu.

Od 24 sierpnia 2026 r. w przypadku wszystkich formatów filmów (długich filmów, transmisji na żywo i filmów Short) na kanale viewCount będzie aktualizować sposób zliczania wyświetleń, aby były one liczone od momentu rozpoczęcia odtwarzania filmu (obejmuje to autoodtwarzanie, najechanie kursorem i kliknięcie/dotknięcie, aby odtworzyć).
statistics.likeCount unsigned long
Liczba użytkowników, którzy wyrazili swoją aprobatę dla filmu.
statistics.dislikeCount unsigned long
Uwaga: 13 grudnia 2021 r. usługa statistics.dislikeCount została ustawiona jako prywatna. Oznacza to, że właściwość jest uwzględniana w odpowiedzi interfejsu API tylko wtedy, gdy żądanie do interfejsu API zostało uwierzytelnione przez właściciela filmu. Więcej informacji znajdziesz w historii zmian.

Liczba użytkowników, którzy wyrazili swoją dezaprobatę dla filmu.
statistics.favoriteCount unsigned long
Uwaga: ta usługa została wycofana. Wycofanie nastąpi 28 sierpnia 2015 r. Wartość właściwości jest teraz zawsze ustawiona na 0.
statistics.commentCount unsigned long
Liczba komentarzy do filmu.
paidProductPlacementDetails object
Obiekt paidProductPlacementDetails zawiera informacje o płatnym lokowaniu produktu w filmie.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Ustaw wartość true, jeśli treści zawierają płatne lokowanie produktu. Domyślna wartość to false.
player object
Obiekt player zawiera informacje, które można wykorzystać do odtworzenia filmu w odtwarzaczu umieszczonym na stronie.
player.embedHtml string
Tag <iframe>, który osadza odtwarzacz odtwarzający film.
  • Jeśli żądanie do interfejsu API dotyczące pobrania zasobu określa wartość parametrów maxHeight lub maxWidth, rozmiar odtwarzacza osadzonego jest skalowany tak, aby spełniać wymagania maxHeight lub maxWidth.
  • Jeśli format obrazu filmu jest nieznany, odtwarzacz umieszczony na stronie domyślnie używa formatu 4:3.
player.embedHeight long
Wysokość odtwarzacza umieszczonego na stronie zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy żądanie zawiera wartość parametru maxHeight lub maxWidth, a format obrazu filmu jest znany.
player.embedWidth long
Szerokość odtwarzacza umieszczonego na stronie zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy żądanie zawiera wartość parametru maxHeight lub maxWidth, a format obrazu filmu jest znany.
topicDetails object
Obiekt topicDetails zawiera informacje o tematach powiązanych z filmem.

Ważne: zapoznaj się z definicjami właściwości topicDetails.relevantTopicIds[] i topicDetails.topicIds[] oraz z historią zmian, aby dowiedzieć się więcej o nadchodzących zmianach związanych z identyfikatorami tematów.
topicDetails.topicIds[] list
Ważne: ta właściwość została wycofana 10 listopada 2016 r. Interfejs API nie zwraca już wartości tej właściwości, a wszystkie tematy powiązane z filmem są teraz zwracane przez wartość właściwości topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Lista identyfikatorów tematów, które są powiązane z filmem.

Ta właściwość została wycofana 10 listopada 2016 r. Będzie on obsługiwany do 10 listopada 2017 r.

Ważne: 27 lutego 2017 r. w związku z wycofaniem Freebase i interfejsu Freebase API identyfikatory tematów zaczęły działać inaczej. W tym czasie YouTube zaczął zwracać niewielki zestaw wyselekcjonowanych identyfikatorów tematów.
topicDetails.topicCategories[] list
Lista adresów URL Wikipedii, które zawierają ogólny opis treści filmu.
recordingDetails object
Obiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie nagrania filmu.
recordingDetails.locationDescription string
Ta usługa została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Tekstowy opis lokalizacji, w której nagrano film.
recordingDetails.location object
Ta właściwość została wycofana. Wszystkie właściwości podrzędne (szerokość geograficzna, długość geograficzna, wysokość) są wycofane.

Informacje o geolokalizacji powiązane z filmem. Wartości usługi podrzędnej określają lokalizację, którą właściciel filmu chce z nim powiązać. Wartość można edytować, wyszukiwać w publicznych filmach i może być ona wyświetlana użytkownikom w przypadku publicznych filmów.
recordingDetails.location.latitude double
Ta usługa została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Szerokość geograficzna w stopniach.
recordingDetails.location.longitude double
Ta właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Długość geograficzna w stopniach.
recordingDetails.location.altitude double
Ta usługa została wycofana 9 lipca 2018 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Wysokość nad elipsoidą odniesienia w metrach.
recordingDetails.recordingDate datetime
Data i godzina nagrania filmu. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
Obiekt fileDetails zawiera informacje o pliku wideo przesłanym do YouTube, w tym rozdzielczość, czas trwania, kodeki audio i wideo, szybkość transmisji bitów strumienia i inne. Te dane może pobrać tylko właściciel filmu.

Obiekt fileDetails zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.fileAvailability ma wartość available.
fileDetails.fileName string
Nazwa przesłanego pliku. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku.
fileDetails.fileSize unsigned long
Rozmiar przesłanego pliku w bajtach. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku.
fileDetails.fileType string
Typ przesłanego pliku wykryty przez silnik przetwarzania filmów w YouTube. Obecnie YouTube przetwarza tylko pliki wideo, ale to pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku.

Prawidłowe wartości tej właściwości to:
  • archive – plik jest plikiem archiwum, np .plikiem ZIP.
  • audio – plik jest znanym typem pliku audio, np .plikiem MP3.
  • document – plik jest dokumentem lub plikiem tekstowym, np. dokumentem MS Word.
  • image – plik jest plikiem graficznym, np. obrazem .jpeg.
  • other – plik jest innego typu niż plik wideo.
  • project – plik jest plikiem projektu wideo, np. projektu Microsoft Windows Movie Maker, który nie zawiera rzeczywistych danych wideo.
  • video – Plik jest znanego typu pliku wideo, np. .mp4.
fileDetails.container string
Format kontenera przesłanego pliku wideo.
fileDetails.videoStreams[] list
Lista strumieni wideo zawartych w przesłanym pliku wideo. Każdy element na liście zawiera szczegółowe metadane dotyczące strumienia wideo.
fileDetails.videoStreams[].widthPixels unsigned integer
Szerokość zakodowanych treści wideo w pikselach. Format obrazu kodowania filmu można obliczyć jako width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Wysokość zakodowanych treści wideo w pikselach.
fileDetails.videoStreams[].frameRateFps double
Liczba klatek na sekundę w strumieniu wideo.
fileDetails.videoStreams[].aspectRatio double
Format obrazu treści wideo, który określa format obrazu, w jakim film powinien być wyświetlany.
fileDetails.videoStreams[].codec string
Kodek wideo używany przez strumień.
fileDetails.videoStreams[].bitrateBps unsigned long
Szybkość transmisji bitów strumienia wideo w bitach na sekundę.
fileDetails.videoStreams[].rotation string
Wartość, o jaką YouTube musi obrócić oryginalne treści źródłowe, aby prawidłowo wyświetlić film.

Prawidłowe wartości tej właściwości to:
  • clockwise – film należy obrócić o 90 stopni w prawo.
  • counterClockwise – film należy obrócić o 90 stopni w lewo.
  • none – filmu nie trzeba obracać.
  • other – film musi zostać obrócony w inny, nietypowy sposób.
  • upsideDown – film należy obrócić do góry nogami.
fileDetails.videoStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.audioStreams[] list
Lista strumieni audio zawartych w przesłanym pliku wideo. Każdy element na liście zawiera szczegółowe metadane dotyczące strumienia audio.
fileDetails.audioStreams[].channelCount unsigned integer
Liczba kanałów audio, które zawiera strumień.
fileDetails.audioStreams[].codec string
Kodek audio używany przez strumień.
fileDetails.audioStreams[].bitrateBps unsigned long
Szybkość transmisji bitów strumienia audio w bitach na sekundę.
fileDetails.audioStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę wideo. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.durationMs unsigned long
Długość przesłanego filmu w milisekundach.
fileDetails.bitrateBps unsigned long
Łączna szybkość transmisji bitów (obrazu i dźwięku) przesłanego pliku wideo w bitach na sekundę.
fileDetails.creationTime string
Data i godzina utworzenia przesłanego pliku wideo. Wartość jest podana w formacie ISO 8601. Obecnie obsługiwane są te formaty ISO 8601:
  • Tylko data: YYYY-MM-DD
  • Czas bez strefy czasowej: YYYY-MM-DDTHH:MM:SS
  • Czas ze strefą czasową: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Obiekt processingDetails zawiera informacje o postępach YouTube w przetwarzaniu przesłanego pliku wideo. Właściwości obiektu określają bieżący stan przetwarzania i szacowany czas pozostały do zakończenia przetwarzania filmu przez YouTube. W tej części znajdziesz też informacje o tym, czy dla filmu są dostępne różne typy danych lub treści, takie jak szczegóły pliku lub miniatury.

Obiekt processingProgress jest przeznaczony do sondowania, aby przesłany film mógł śledzić postępy YouTube w przetwarzaniu przesłanego pliku wideo. Te dane może pobrać tylko właściciel filmu.
processingDetails.processingStatus string
Stan przetwarzania filmu. Ta wartość wskazuje, czy YouTube udało się przetworzyć film, czy też film jest nadal przetwarzany.

Prawidłowe wartości tej właściwości to:
  • failed – nie udało się przetworzyć filmu. Zobacz ProcessingFailureReason.
  • processing – film jest obecnie przetwarzany. Zobacz ProcessingProgress.
  • succeeded – film został przetworzony.
  • terminated – informacje o przetwarzaniu nie są już dostępne.
processingDetails.processingProgress object
Obiekt processingProgress zawiera informacje o postępach YouTube w przetwarzaniu filmu. Wartości te są istotne tylko wtedy, gdy stan przetwarzania filmu to processing.
processingDetails.processingProgress.partsTotal unsigned long
Szacunkowa łączna liczba części, które muszą zostać przetworzone w przypadku filmu. Podczas przetwarzania filmu przez YouTube liczba może zostać zaktualizowana o dokładniejsze szacunki.
processingDetails.processingProgress.partsProcessed unsigned long
Liczba części filmu, które zostały już przetworzone przez YouTube. Możesz oszacować procent filmu, który został już przetworzony przez YouTube, obliczając:
100 * parts_processed / parts_total

Pamiętaj, że szacowana liczba części może wzrosnąć bez odpowiedniego wzrostu liczby części, które zostały już przetworzone. Możliwe jest więc, że obliczony postęp będzie się okresowo zmniejszać podczas przetwarzania filmu przez YouTube.
processingDetails.processingProgress.timeLeftMs unsigned long
Szacunkowy czas w milisekundach, jaki YouTube potrzebuje na przetworzenie filmu.
processingDetails.processingFailureReason string
Powód, dla którego YouTube nie udało się przetworzyć filmu. Ta właściwość będzie miała wartość tylko wtedy, gdy właściwość processingStatus będzie miała wartość failed.

Prawidłowe wartości tej właściwości to:
  • other – wystąpił błąd w innym komponencie przetwarzania.
  • streamingFailed – nie udało się wysłać filmu do streamerów.
  • transcodeFailed – transkodowanie treści się nie powiodło.
  • uploadFailed – nie udało się dostarczyć pliku.
processingDetails.fileDetailsAvailability string
Ta wartość wskazuje, czy szczegóły pliku są dostępne dla przesłanego filmu. Możesz pobrać szczegóły pliku wideo, wysyłając żądanie videos.list() z częścią fileDetails.
processingDetails.processingIssuesAvailability string
Ta wartość wskazuje, czy mechanizm przetwarzania filmu wygenerował sugestie, które mogą poprawić zdolność YouTube do przetwarzania filmu, ostrzeżenia wyjaśniające problemy z przetwarzaniem filmu lub błędy, które powodują problemy z przetwarzaniem filmu. Możesz pobrać te sugestie, wysyłając w videos.list()zapytaniu część suggestions.
processingDetails.tagSuggestionsAvailability string
Ta wartość wskazuje, czy dla filmu są dostępne sugestie słów kluczowych (tagów). Tagi można dodawać do metadanych filmu, aby ułatwić innym użytkownikom znalezienie go. Możesz pobrać te sugestie, wysyłając żądanie videos.list() z częścią suggestions.
processingDetails.editorSuggestionsAvailability string
Ta wartość wskazuje, czy dla filmu są dostępne sugestie dotyczące edycji, które mogą poprawić jakość filmu lub odtwarzania. Możesz pobrać te sugestie, wysyłając w videos.list()zapytaniu część suggestions.
processingDetails.thumbnailsAvailability string
Ta wartość wskazuje, czy dla filmu wygenerowano miniatury.
suggestions object
Obiekt suggestions zawiera sugestie, które wskazują możliwości poprawy jakości filmu lub metadanych przesłanego filmu. Te dane może pobrać tylko właściciel filmu.

Obiekt suggestions zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.tagSuggestionsAvailability lub processingDetails.editorSuggestionsAvailability ma wartość available.
suggestions.processingErrors[] list
Lista błędów, które uniemożliwią YouTube przetworzenie przesłanego filmu. Te błędy wskazują, że niezależnie od bieżącego stanu przetwarzania filmu ostatecznie będzie on prawie na pewno miał wartość failed.

Prawidłowe wartości tej właściwości to:
  • archiveFile – plik archiwum (np. plik ZIP).
  • audioFile – plik zawiera tylko dźwięk (np. plik MP3).
  • docFile – dokument lub plik tekstowy (np. dokument MS Word).
  • imageFile – plik graficzny (np. obraz JPEG).
  • notAVideoFile – inny plik, który nie jest filmem.
  • projectFile – plik projektu filmu (np. projekt programu Microsoft Windows Movie Maker);
suggestions.processingWarnings[] list
Lista powodów, dla których YouTube może mieć trudności z transkodowaniem przesłanego filmu lub które mogą spowodować błędne transkodowanie. Te ostrzeżenia są generowane, zanim YouTube przetworzy przesłany plik wideo. Ponadto identyfikują problemy, które niekoniecznie oznaczają, że przetwarzanie filmu się nie powiedzie, ale mogą powodować problemy, takie jak problemy z synchronizacją, artefakty wideo lub brak ścieżki audio.

Prawidłowe wartości tej właściwości to:
  • hasEditlist – edytowanie list nie jest obecnie obsługiwane.
  • inconsistentResolution – konflikt rozdzielczości kontenera i strumienia.
  • problematicAudioCodec – użyto kodeka audio, który może powodować problemy.
  • problematicVideoCodec – użyto kodeka wideo, który powoduje problemy.
  • unknownAudioCodec – nierozpoznany kodek audio, transkodowanie prawdopodobnie się nie powiedzie.
  • unknownContainer – nierozpoznany format pliku, transkodowanie prawdopodobnie się nie powiedzie.
  • unknownVideoCodec – nierozpoznany kodek wideo, transkodowanie prawdopodobnie się nie powiedzie.
suggestions.processingHints[] list
Lista sugestii, które mogą poprawić zdolność YouTube do przetwarzania filmu.

Prawidłowe wartości tej właściwości to:
  • nonStreamableMov – plik MP4 nie nadaje się do strumieniowania, co spowolni przetwarzanie.
  • sendBestQualityVideo – prawdopodobnie istnieje wersja filmu w lepszej jakości.
suggestions.tagSuggestions[] list
Lista tagów słów kluczowych, które można dodać do metadanych filmu, aby zwiększyć prawdopodobieństwo, że użytkownicy znajdą Twój film podczas wyszukiwania lub przeglądania treści w YouTube.
suggestions.tagSuggestions[].tag string
Tag słowa kluczowego sugerowany dla filmu.
suggestions.tagSuggestions[].categoryRestricts[] list
Zbiór kategorii filmów, do których pasuje tag. Możesz użyć tych informacji, aby wyświetlać odpowiednie sugestie tagów na podstawie kategorii filmu, którą przesyłający powiązał z filmem. Domyślnie sugestie tagów są odpowiednie dla wszystkich kategorii, jeśli dla słowa kluczowego nie zdefiniowano żadnych ograniczeń.
suggestions.editorSuggestions[] list
Lista operacji edycji filmu, które mogą poprawić jakość lub odtwarzanie przesłanego filmu.

Prawidłowe wartości tej właściwości to:
  • audioQuietAudioSwap – ścieżka audio wydaje się być wyciszona i można ją zastąpić ścieżką o lepszej jakości.
  • videoAutoLevels – poziomy jasności obrazu wydają się nieprawidłowe i można je poprawić.
  • videoCrop – marginesy (passe-partout) wykryte wokół zdjęcia mogą zostać przycięte.
  • videoStabilize – film jest niestabilny i można go ustabilizować.
liveStreamingDetails object
Obiekt liveStreamingDetails zawiera metadane dotyczące transmisji na żywo. Obiekt będzie obecny w zasobie video tylko wtedy, gdy film jest nadchodzącą, trwającą lub zakończoną transmisją na żywo.
liveStreamingDetails.actualStartTime datetime
Czas, kiedy transmisja faktycznie się rozpoczęła. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po rozpoczęciu transmisji.
liveStreamingDetails.actualEndTime datetime
Czas rzeczywistego zakończenia transmisji. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji.
liveStreamingDetails.scheduledStartTime datetime
Godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Czas, w którym transmisja ma się zakończyć. Wartość jest podana w formacie ISO 8601. Jeśli wartość jest pusta lub właściwość nie występuje, transmisja jest zaplanowana na czas nieokreślony.
liveStreamingDetails.concurrentViewers unsigned long
Liczba widzów, którzy aktualnie oglądają transmisję. Właściwość i jej wartość będą obecne, jeśli transmisja ma aktualnie widzów, a właściciel transmisji nie ukrył liczby wyświetleń filmu. Pamiętaj, że po zakończeniu transmisji YouTube przestaje śledzić liczbę widzów oglądających ją w tym samym czasie. Ta właściwość nie określa więc liczby widzów oglądających archiwalny film z zakończonej już transmisji na żywo.
Liczba jednoczesnych widzów zwracana przez interfejs YouTube Data API może się różnić od przetworzonej liczby jednoczesnych widzów po odfiltrowaniu spamu, która jest dostępna w Statystykach YouTube. Więcej informacji o danych transmisji na żywo znajdziesz w Centrum pomocy YouTube.
liveStreamingDetails.activeLiveChatId string
Identyfikator aktywnego czatu na żywo dołączonego do tego filmu. To pole jest wypełniane tylko wtedy, gdy film jest aktualnie transmitowany na żywo i ma czat na żywo. Gdy transmisja przejdzie do tego etapu, to pole zostanie usunięte, a czat na żywo zostanie zamknięty. W przypadku stałych transmisji identyfikator czatu na żywo nie będzie już powiązany z tym filmem, ale z nowym filmem wyświetlanym na stałej stronie.
brandPartner object
Obiekt brandPartner zawiera szczegółowe informacje o marce połączonej z filmem w ramach dostępu marki z inicjatywy twórcy.
brandPartner.channelId string
Zewnętrzny identyfikator kanału marki, z którą współpracujesz. To pole musi zaczynać się od „UC”. Podczas konfigurowania dostępu należy ustawić channelId lub channelHandle, ale w odpowiedzi zwracany jest tylko channelId.
brandPartner.channelHandle string
Nick kanału marki, z którą współpracujesz. To pole musi zaczynać się od „@”. Podczas ustanawiania dostępu należy ustawić channelId lub channelHandle, ale w odpowiedzi zwracane jest tylko channelId.
localizations object
Obiekt localizations zawiera tłumaczenia metadanych filmu.
localizations.(key) object
Język zlokalizowanego tekstu powiązanego z wartością klucza. Wartość jest ciągiem znaków zawierającym kod języka BCP-47.
localizations.(key).title string
Zlokalizowany tytuł filmu.
localizations.(key).description string
Zlokalizowany opis filmu.