Videos

Wszystkie filmy przesłane przy użyciu punktu końcowego videos.insert z niezweryfikowanych projektów API utworzonych po 28 lipca 2020 roku będą miały ograniczony dostęp do trybu prywatnego. Aby znieść to ograniczenie, każdy projekt interfejsu API musi przejść audyt w celu weryfikacji zgodności z Warunkami usługi. Więcej informacji znajdziesz w historii zmian interfejsu API.

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ł określonej liście filmów. 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
wstaw
Przesyła film do YouTube i opcjonalnie ustawia metadane filmu.
aktualizować
Aktualizuje metadane filmu. Wypróbuj teraz
usuń
Usuwa film na YouTube. Wypróbuj teraz
rate [stawka]
Dodawanie oceny „Lubię” lub „Nie lubię” do filmu albo usuwanie oceny z filmu. Wypróbuj teraz
reportAbuse
Zgłoś film, który zawiera nieodpowiednie treści. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia 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 tej tabeli znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

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

Istnieje kilka szczególnych przypadków:
  • Jeśli film zostanie przesłany jako film prywatny, a właściciel kanału pobierze jego metadane, wartość właściwości określa datę i godzinę przesłania filmu.
  • Jeśli film zostanie 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 zostanie 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 jednoznacznej identyfikacji kanału, na który został przesłany film. Ta wartość może się zmieniać z czasem, 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 <>. 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 zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >.

Aby utworzyć rozdziały filmu, w tekście opisu umieść sformatowane sygnatury czasowe (np. 00:00).
snippet.thumbnails object
Mapa miniatur powiązanych z filmem. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key) object
Prawidłowe wartości klucza to:
  • default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. 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 odwołuje się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
  • 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 się do nich odnoszą, np. elementów playlisty czy wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli.
  • 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 czy wyniki wyszukiwania. Ten obraz ma szerokość 1280 pikseli i wysokość 720 pikseli.
  • 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 – miniatura w ultrawysokiej rozdzielczości (4K). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma szerokość 3840 pikseli i wysokość 2160 pikseli.
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 wliczają się do limitu.
  • Jeśli tag zawiera spację, serwer 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 limitów 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.titlesnippet.description zasobu video.
snippet.localized object
Obiekt snippet.localized zawiera zlokalizowany tytuł i opis filmu lub tytuł w języku domyślnym dla metadanych filmu.
  • Zlokalizowany tekst jest zwracany we fragmencie zasobu, jeśli w żądaniu videos.list użyto parametru hl do określenia języka, w którym ma być zwracany zlokalizowany tekst i 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 określono wartość, ale zlokalizowane metadane nie są dostępne dla wybranego języka.
Właściwość zawiera wartość tylko do odczytu. Użyj obiektu localizations, aby dodawać, aktualizować lub usuwać 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 na domyślnej ścieżce audio filmu.
contentDetails object
Obiekt contentDetails zawiera informacje o treści filmu, w tym jego długość i wskazanie, 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 minutę, ale nie dłużej niż godzinę, czas trwania jest podawany w formacie PT#M#S, w którym litery PT oznaczają, ż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 MS to liczby całkowite określające liczbę minut (lub sekund) filmu. Na przykład wartość PT15M33S oznacza, ż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 PT 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 3D czy w 2D.
contentDetails.definition string
Określa, czy film jest dostępny w wysokiej rozdzielczości (HD), czy tylko w standardowej.

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

Prawidłowe wartości tej właściwości to:
  • false
  • true
contentDetails.licensedContent boolean
Wskazuje, czy film zawiera licencjonowane treści, 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 jest blokowany 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 jest widoczny we wszystkich krajach.
contentDetails.contentRating object
Określa oceny, jakie otrzymał film w ramach różnych systemów oceniania.
contentDetails.contentRating.acbRating string
Ocena filmu przyznana przez Australian Classification Board (ACB) lub Australian Communications and Media Authority (ACMA). Oceny ACMA służą 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 – M
  • acbMa15plus – MA15+
  • acbP – programy, którym Australian Communications and Media Authority przyznała klasyfikację P. Te programy są przeznaczone dla dzieci w wieku przedszkolnym.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Ocena filmu przyznana przez włoski organ Autorità per le Garanzie nelle Comunicazioni (AGCOM).

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

Prawidłowe wartości tego atrybutu 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 przyznana przez British Board of Film Classification (BBFC).

Prawidłowe wartości tej właściwości to:
  • 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ę Cenzorów Filmów i Materiałów Wideo.

Prawidłowe wartości tej właściwości to:
  • 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 oceniania kanadyjskich programów telewizyjnych – kanadyjski system klasyfikacji programów telewizyjnych. Ocena filmu przyznana przez Kanadyjską Komisję ds. Radia i Telewizji (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 to:
  • catv14plus – 14+
  • 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 to:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Ocena filmu przyznana przez Centralną Radę Cenzury Filmowej (CBFC) w Indiach.

Prawidłowe wartości tej właściwości to:
  • 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ą organizację 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 tego atrybutu to:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Ocena filmu w kanadyjskim systemie klasyfikacji filmów do użytku domowego (CHVRS).

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

Prawidłowe wartości tej właściwości to:
  • 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 tego atrybutu to:
  • 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 tego atrybutu 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 – Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Ocena filmu w Luksemburgu przyznana przez Commission de surveillance de la classification des films (CSCF).

Prawidłowe wartości tej właściwości:
  • 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 przyznana przez Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT) w Brazylii.

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
Przyczyny, dla których film otrzymał ocenę DJCQT (Brazylia).
contentDetails.contentRating.ecbmctRating string
System ocen w Turcji – Rada ds. Oceny i Klasyfikacji przy Ministerstwie Kultury i Turystyki

Prawidłowe wartości tego atrybutu to:
  • ecbmct13a – 13A
  • ecbmct13plus – 13+
  • 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 tego atrybutu to:
  • eefilmK12 – K-12
  • 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 to:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Klasyfikacja filmu według EIRIN (映倫). Eirin to japoński system ocen.

Prawidłowe wartości tego atrybutu 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 to:
  • 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 przyznana przez Office for Film, Newspaper and Article Administration w Hongkongu.

Prawidłowe wartości tej właściwości to:
  • 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 przyznana przez Centre national du cinéma et de l'image animé (francuskie Ministerstwo Kultury).

Prawidłowe wartości tej właściwości to:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Ocena filmu przyznana przez Film and Publication Board w Republice Południowej Afryki.

Prawidłowe wartości tej właściwości to:
  • 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
Klasyfikacja filmu według 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 – K-12
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Ocena filmu przyznana przez Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Hiszpania).

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

Prawidłowe wartości tej właściwości to:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Ocena filmu przyznana przez INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentyna).

Prawidłowe wartości tej właściwości to:
  • 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 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Ocena filmu przyznana przez Kenya Film Classification Board.

Prawidłowe wartości tego atrybutu to:
  • 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 przyznana przez Korea Media Rating Board (영상물등급위원회). KMRB ocenia filmy w Korei Południowej.

Prawidłowe wartości tego atrybutu to:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Ocena filmu przyznana przez indonezyjską organizację Lembaga Sensor Film.

Prawidłowe wartości tego atrybutu to:
  • 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 (Media Council for Children and Young People) Duńskiego Instytutu Filmowego (Det Danske Filminstitut).

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

Prawidłowe wartości tej właściwości:
  • 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 przyznana przez singapurski urząd Media Development Authority (MDA), a konkretnie przez jego Board of Film Censors (BFC).

Prawidłowe wartości tej właściwości to:
  • 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 tego atrybutu 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 przyznana przez Ministerio de Cultura (Kolumbia).

Prawidłowe wartości tej właściwości to:
  • 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 tego atrybutu to:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Ocena zwiastunów i zapowiedzi filmów przyznana przez Motion Picture Association of America.

Prawidłowe wartości tej właściwości to:
  • 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 z Filipińskiej Rady ds. Oceny i Klasyfikacji Filmów i Programów Telewizyjnych.

Prawidłowe wartości tej właściwości to:
  • 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 Bułgarskie Narodowe Centrum Filmowe.

Prawidłowe wartości tej właściwości to:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Ocena filmu przyznana przez nigeryjską 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 to:
  • oflcG – G
  • oflcM – M
  • 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 tego atrybutu to:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Ocena filmu w Wenezueli.

Prawidłowe wartości tego pola to:
  • 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 tej właściwości to:
  • 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 w Słowacji.

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

Prawidłowe wartości tego atrybutu to:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Ocena filmu przyznana przez Statens medieråd (szwedzką Radę ds. Mediów).

Prawidłowe wartości tej właściwości to:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – wszystkie grupy wiekowe
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Ocena treści wideo zgodnie z wytycznymi TV Parental Guidelines (TVPG).

Prawidłowe wartości tego atrybutu to:
  • 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
Określa, czy przesyłający film udostępnił niestandardową miniaturę filmu. 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 tej właściwości 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.

Prawidłowe wartości tego atrybutu to:
  • private
  • public
  • unlisted
status.publishAt datetime
Data i godzina zaplanowanej publikacji filmu. Można go ustawić tylko wtedy, gdy film jest ustawiony jako prywatny. Wartość jest podana w formacie ISO 8601. Weź pod uwagę te 2 dodatkowe informacje o działaniu tej usługi:
  • 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 nigdy nie został opublikowany.
  • Jeśli w żądaniu zaplanujesz publikację filmu na jakiś czas w przeszłości, zostanie on opublikowany od razu. Dlatego ustawienie właściwości status.publishAt na datę i godzinę w przeszłości ma taki sam efekt jak zmiana wartości privacyStatus filmu z private na public.
status.license string
Licencja filmu.

Prawidłowe wartości tego pola to:
  • creativeCommon
  • youtube
status.embeddable boolean
Ta wartość wskazuje, czy film można umieścić w innej witrynie.

status.publicStatsViewable boolean
Ta wartość informuje, czy rozszerzone statystyki filmu na stronie odtwarzania filmu są widoczne publicznie. Domyślnie te statystyki są widoczne, a statystyki takie jak liczba wyświetleń i oceny filmu nadal będą 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ść umożliwia właścicielowi kanału oznaczenie filmu jako skierowanego do dzieci. W przypadku żądania 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 lubvideos.update ta właściwość umożliwia właścicielowi kanału poinformowanie, że film zawiera realistyczne treści zmodyfikowane lub wygenerowane syntetycznie (A/S). Dowiedz się więcej o zasadach YouTube dotyczących treści związanych z alkoholem, tytoniem i innymi substancjami.

Przykłady treści związanych z alkoholem, tytoniem i innymi substancjami obejmują filmy, które:
  • sprawiać, że prawdziwa osoba wydaje się mówić lub robić coś, czego w rzeczywistości nie powiedziała ani nie zrobiła;
  • zmieniać materiał przedstawiający prawdziwe wydarzenie lub miejsce;
  • generować realistycznie wyglądającą scenę, 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 aktualizowany, aby zliczać wyświetlenia od momentu rozpoczęcia odtwarzania filmu (obejmuje to autoodtwarzanie, najechanie wskaźnikiem i kliknięcie/dotknięcie, aby odtworzyć).

statistics.likeCount unsigned long
Liczba użytkowników, którzy polubili film.
statistics.dislikeCount unsigned long
Uwaga: od 13 grudnia 2021 r. usługa statistics.dislikeCount jest prywatna. Oznacza to, że usługa 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 właściwość została wycofana. Wycofanie nastąpiło 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 w treściach występuje płatne lokowanie produktu. Domyślna wartość to false.
player object
Obiekt player zawiera informacje, które umożliwiają odtworzenie 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 osadzonego odtwarzacza jest skalowany tak, aby spełniać wymagania maxHeight lub maxWidth.
  • Jeśli współczynnik proporcji filmu jest nieznany, odtwarzacz osadzony domyślnie przyjmuje format 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 w żądaniu określono wartość parametrów maxHeight lub maxWidth i znany jest współczynnik proporcji filmu.
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 w żądaniu określono wartość parametrów maxHeight lub maxWidth i znany jest współczynnik proporcji filmu.
topicDetails object
Obiekt topicDetails zawiera informacje o tematach powiązanych z filmem.

Ważne: definicje właściwości topicDetails.relevantTopicIds[]topicDetails.topicIds[] oraz historię zmian znajdziesz w artykule o nadchodzących zmianach związanych z identyfikatorami tematów.
topicDetails.topicIds[] list
Ważne: to pole zostało wycofane 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 związanych 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: ze względu na wycofanie Freebase i interfejsu Freebase API identyfikatory tematów zaczęły działać inaczej od 27 lutego 2017 r. 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, pod którym nagrano film.
recordingDetails.locationDescription string
Ta właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Tekstowy opis miejsca, w którym nagrano film.
recordingDetails.location object
Ta właściwość została wycofana. Wszystkie jego 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 powiązać z filmem. Wartość można edytować, wyszukiwać w publicznych filmach i może być wyświetlana użytkownikom w przypadku publicznych filmów.
recordingDetails.location.latitude double
Ta właściwość 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ść pliku, czas trwania, kodeki audio i wideo, szybkość transmisji strumieniowej 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 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 obrazu, np .obrazem w formacie JPEG.
  • other – plik ma inny typ niż wideo.
  • project – plik jest plikiem projektu wideo, np. projektem programu Microsoft Windows Movie Maker, który nie zawiera rzeczywistych danych wideo.
  • video – plik jest znanym typem pliku wideo, np .plikiem 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ść zakodowanej treści wideo w pikselach. Współczynnik proporcji kodowania filmu możesz obliczyć jako width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Wysokość zakodowanej 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, w jakim formacie obrazu film powinien być wyświetlany.
fileDetails.videoStreams[].codec string
Kodek wideo używany przez strumień.
fileDetails.videoStreams[].bitrateBps unsigned long
Szybkość transmisji strumienia wideo w bitach na sekundę.
fileDetails.videoStreams[].rotation string
Wartość, o jaką YouTube musi obrócić oryginalne źródło treści, 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 – film nie wymaga obrócenia.
  • other – film musi być obrócony w inny, nietrywialny 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 listy zawiera szczegółowe metadane 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 strumienia audio w bitach na sekundę.
fileDetails.audioStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę filmów. 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 lokalny: 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ż informację, 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 odpytywania, 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ść informuje, czy YouTube udało się przetworzyć film, czy jest on 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
Szacowana łą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 szacunkowa liczba części może wzrosnąć bez odpowiedniego wzrostu liczby części, które zostały już przetworzone. Dlatego podczas przetwarzania filmu przez YouTube obliczony postęp może okresowo maleć.
processingDetails.processingProgress.timeLeftMs unsigned long
Szacowany czas w milisekundach, jaki YouTube potrzebuje na zakończenie przetwarzania filmu.
processingDetails.processingFailureReason string
Przyczyna, dla której YouTube nie udało się przetworzyć filmu. Ta właściwość będzie miała wartość tylko wtedy, gdy wartość właściwości processingStatus to failed.

Prawidłowe wartości tej właściwości to:
  • other – nie udało się przetworzyć danych w innym komponencie.
  • streamingFailed – nie udało się wysłać filmu do streamerów.
  • transcodeFailed – nie udało się zmienić formatu treści.
  • uploadFailed – nie udało się dostarczyć pliku.
processingDetails.fileDetailsAvailability string
Ta wartość informuje, czy szczegóły pliku są dostępne w przypadku przesłanego filmu. Szczegóły pliku filmu możesz uzyskać, wysyłając w żądaniu videos.list() prośbę o fileDetails.
processingDetails.processingIssuesAvailability string
Ta wartość wskazuje, czy silnik przetwarzania filmów 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, przesyłając w żądaniu videos.list() 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 jego znalezienie. Możesz pobrać te sugestie, przesyłając w żądaniu videos.list() część suggestions.
processingDetails.editorSuggestionsAvailability string
Ta wartość wskazuje, czy dla filmu dostępne są sugestie dotyczące edycji, które mogą poprawić jakość filmu lub wrażenia z odtwarzania. Możesz pobrać te sugestie, przesyłając w żądaniu videos.list() 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 poprawne przetworzenie przesłanego filmu. Te błędy wskazują, że niezależnie od bieżącego stanu przetwarzania filmu ostatecznie stan ten prawie na pewno będzie miał wartość failed.

Prawidłowe wartości tej właściwości to:
  • archiveFile – plik archiwum (np. archiwum ZIP);
  • audioFile – plik zawiera tylko dźwięk (np. plik MP3).
  • docFile – dokument lub plik tekstowy (np. dokument MS Word).
  • imageFile – plik obrazu (np. obraz JPEG);
  • notAVideoFile – inny plik niż film.
  • 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 przekodowaniem przesłanego filmu lub które mogą spowodować błędne przekodowanie. Te ostrzeżenia są generowane, zanim YouTube przetworzy przesłany plik wideo. Oprócz tego wykrywają problemy, które niekoniecznie oznaczają, że przetwarzanie filmu się nie powiedzie, ale mogą powodować problemy, takie jak brak synchronizacji, 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 między rozdzielczością kontenera a rozdzielczością strumienia.
  • problematicAudioCodec – użyto kodeka audio, który powoduje znane problemy.
  • problematicVideoCodec – użyto kodeka wideo, który może powodować 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ć możliwości przetwarzania filmu przez YouTube.

Prawidłowe wartości tej właściwości to:
  • nonStreamableMov – plik MP4 nie nadaje się do przesyłania strumieniowego, co spowolni przetwarzanie.
  • sendBestQualityVideo – prawdopodobnie istnieje wersja filmu o 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 w YouTube.
suggestions.tagSuggestions[].tag string
Tag słowa kluczowego sugerowany dla filmu.
suggestions.tagSuggestions[].categoryRestricts[] list
Zbiór kategorii filmów, w przypadku których tag jest odpowiedni. Na podstawie tych informacji możesz wyświetlać odpowiednie sugestie tagów w zależności od kategorii filmu, którą osoba przesyłająca film powiązała 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 wideo, które mogą poprawić jakość filmu lub wrażenia z odtwarzania przesłanego filmu.

Prawidłowe wartości tej właściwości to:
  • audioQuietAudioSwap – ścieżka dźwiękowa wydaje się cicha 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ół obrazu mogą zostać przycięte.
  • videoStabilize – film jest niestabilny i można go ustabilizować.
liveStreamingDetails object
Obiekt liveStreamingDetails zawiera metadane dotyczące transmisji wideo 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
Godzina rozpoczęcia transmisji. 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
Zaplanowana godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Godzina, o której ma się zakończyć transmisja. 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ę. Usługa i jej wartość będą widoczne, jeśli transmisja ma aktualnych 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. W związku z tym ta właściwość nie określa liczby widzów oglądających zarchiwizowany film z transmisji na żywo, która już się zakończyła.
Liczba widzów oglądających transmisję na żywo w tym samym czasie, którą zwraca interfejs YouTube Data API, może różnić się od przetworzonej i oczyszczonej z niechcianych treści liczby widzów oglądających transmisję na żywo w tym samym czasie, 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 obecnie aktywnego czatu na żywo dołączonego do tego filmu. To pole jest wypełniane tylko wtedy, gdy film jest obecnie transmitowany na żywo i ma czat na żywo. Gdy transmisja się zakończy, to pole zostanie usunięte, a czat na żywo zostanie zamknięty. W przypadku transmisji ciągłych identyfikator czatu na żywo nie będzie już powiązany z tym filmem, ale z nowym filmem wyświetlanym na stronie ciągłej.
brandPartner object
Obiekt brandPartner zawiera szczegóły dotyczące marki powiązanej z filmem w ramach dostępu marki inicjowanego przez twórcę (CI BPA).
brandPartner.channelId string
Zewnętrzny identyfikator kanału partnera marki. To pole musi zaczynać się od „UC”. Podczas przyznawania dostępu musi być ustawiony atrybut channelId lub channelHandle, ale w odpowiedzi zwracany jest tylko atrybut channelId.
brandPartner.channelHandle string
Nick kanału partnera marki. To pole musi się zaczynać od znaku „@”. Podczas przyznawania dostępu należy ustawić wartość channelId lub channelHandle, ale w odpowiedzi zwracana jest tylko wartość channelId.
localizations object
Obiekt localizations zawiera tłumaczenia metadanych filmu.
localizations.(key) object
Język zlokalizowanego tekstu powiązanego z wartością klucza. Wartość to ciąg znaków zawierający kod języka BCP-47.
localizations.(key).title string
Zlokalizowany tytuł filmu.
localizations.(key).description string
Zlokalizowany opis filmu.