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 |
stringOkreśla typ zasobu interfejsu API. Wartość będzie wynosić youtube#video. |
etag |
etagEtag tego zasobu. |
id |
stringIdentyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu. |
snippet |
objectObiekt snippet zawiera podstawowe informacje o filmie, takie jak tytuł, opis i kategoria. |
snippet.publishedAt |
datetimeData 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:
|
snippet.channelId |
stringIdentyfikator, 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 |
stringTytuł 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 |
stringOpis 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 |
objectMapa 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) |
objectPrawidłowe wartości klucza to:
|
snippet.thumbnails.(key).url |
stringAdres URL obrazu. |
snippet.thumbnails.(key).width |
unsigned integerSzerokość obrazu. |
snippet.thumbnails.(key).height |
unsigned integerWysokość obrazu. |
snippet.channelTitle |
stringTytuł kanału, do którego należy film. |
snippet.tags[] |
listLista 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:
|
snippet.categoryId |
stringKategoria 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 |
stringWskazuje, czy film jest nadchodzącą lub aktywną transmisją na żywo. Jeśli film nie jest nadchodzącą lub aktywną transmisją na żywo, wartość to Prawidłowe wartości tej właściwości to:
|
snippet.defaultLanguage |
stringJęzyk tekstu we właściwościach snippet.title i snippet.description zasobu video. |
snippet.localized |
objectObiekt snippet.localized zawiera zlokalizowany tytuł i opis filmu lub tytuł w języku domyślnym dla metadanych filmu.
localizations, aby dodawać, aktualizować lub usuwać zlokalizowane tytuły. |
snippet.localized.title |
stringZlokalizowany tytuł filmu. |
snippet.localized.description |
stringZlokalizowany opis filmu. |
snippet.defaultAudioLanguage |
stringWłaściwość default_audio_language określa język używany na domyślnej ścieżce audio filmu. |
contentDetails |
objectObiekt contentDetails zawiera informacje o treści filmu, w tym jego długość i wskazanie, czy są dostępne napisy. |
contentDetails.duration |
stringDł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 M i S 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 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 |
stringWskazuje, czy film jest dostępny w 3D czy w 2D. |
contentDetails.definition |
stringOkreś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:
|
contentDetails.caption |
stringWskazuje, czy napisy są dostępne w przypadku filmu. Prawidłowe wartości tej właściwości to:
|
contentDetails.licensedContent |
booleanWskazuje, 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 |
objectObiekt 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[] |
listLista 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[] |
listLista 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 |
objectOkreśla oceny, jakie otrzymał film w ramach różnych systemów oceniania. |
contentDetails.contentRating.acbRating |
stringOcena 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:
|
contentDetails.contentRating.agcomRating |
stringOcena filmu przyznana przez włoski organ Autorità per le Garanzie nelle Comunicazioni (AGCOM). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.anatelRating |
stringOcena filmu przyznana przez Anatel (Asociación Nacional de Televisión) dla telewizji w Chile. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.bbfcRating |
stringOcena filmu przyznana przez British Board of Film Classification (BBFC). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.bfvcRating |
stringOcena filmu przyznana przez tajlandzką Radę Cenzorów Filmów i Materiałów Wideo. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.bmukkRating |
stringOcena 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:
|
contentDetails.contentRating.catvRating |
stringSystem 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:
|
contentDetails.contentRating.catvfrRating |
stringOcena 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:
|
contentDetails.contentRating.cbfcRating |
stringOcena filmu przyznana przez Centralną Radę Cenzury Filmowej (CBFC) w Indiach. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cccRating |
stringOcena filmu przyznana przez Consejo de Calificación Cinematográfica (Chile). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cceRating |
stringOcena filmu przyznana przez portugalską organizację Comissão de Classificação de Espect´culos. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.chfilmRating |
stringOcena filmu w Szwajcarii. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.chvrsRating |
stringOcena filmu w kanadyjskim systemie klasyfikacji filmów do użytku domowego (CHVRS). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cicfRating |
stringOcena filmu przyznana przez Commission de Contrôle des Films (Belgia). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cnaRating |
stringOcena filmu przyznana przez rumuńską organizację CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.cncRating |
stringSystem ocen we Francji – Commission de classification cinematographique Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.csaRating |
stringOcena 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:
|
contentDetails.contentRating.cscfRating |
stringOcena filmu w Luksemburgu przyznana przez Commission de surveillance de la classification des films (CSCF). Prawidłowe wartości tej właściwości:
|
contentDetails.contentRating.czfilmRating |
stringOcena filmu w Czechach. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.djctqRating |
stringOcena 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:
|
contentDetails.contentRating.djctqRatingReasons[] |
listPrzyczyny, dla których film otrzymał ocenę DJCQT (Brazylia). |
contentDetails.contentRating.ecbmctRating |
stringSystem ocen w Turcji – Rada ds. Oceny i Klasyfikacji przy Ministerstwie Kultury i Turystyki Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.eefilmRating |
stringOcena filmu w Estonii. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.egfilmRating |
stringOcena filmu w Egipcie. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.eirinRating |
stringKlasyfikacja filmu według EIRIN (映倫). Eirin to japoński system ocen. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.fcbmRating |
stringOcena filmu przyznana przez malezyjską Radę Cenzury Filmowej. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.fcoRating |
stringOcena filmu przyznana przez Office for Film, Newspaper and Article Administration w Hongkongu. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.fmocRating |
stringTa 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:
|
contentDetails.contentRating.fpbRating |
stringOcena filmu przyznana przez Film and Publication Board w Republice Południowej Afryki. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.fpbRatingReasons[] |
listPrzyczyny, dla których film otrzymał ocenę FPB (RPA). |
contentDetails.contentRating.fskRating |
stringKlasyfikacja filmu według Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Niemcy). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.grfilmRating |
stringOcena filmu w Grecji. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.icaaRating |
stringOcena 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:
|
contentDetails.contentRating.ifcoRating |
stringOcena 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:
|
contentDetails.contentRating.ilfilmRating |
stringOcena filmu w Izraelu. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.incaaRating |
stringOcena filmu przyznana przez INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentyna). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.kfcbRating |
stringOcena filmu przyznana przez Kenya Film Classification Board. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (Netherlands). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.kmrbRating |
stringOcena filmu przyznana przez Korea Media Rating Board (영상물등급위원회). KMRB ocenia filmy w Korei Południowej. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.lsfRating |
stringOcena filmu przyznana przez indonezyjską organizację Lembaga Sensor Film. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.mccaaRating |
stringOcena filmu przyznana przez maltańską Radę ds. Klasyfikacji Wiekowej Filmów. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mccypRating |
stringOcena 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:
|
contentDetails.contentRating.mcstRating |
stringSystem oceniania filmów w Wietnamie – MCST Prawidłowe wartości tej właściwości:
|
contentDetails.contentRating.mdaRating |
stringOcena 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:
|
contentDetails.contentRating.medietilsynetRating |
stringOcena filmu przyznana przez Medietilsynet, norweski organ ds. mediów. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.mekuRating |
stringOcena filmu przyznana przez fiński Kansallinen Audiovisuaalinen Instituutti (Narodowy Instytut Audiowizualny). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mibacRating |
stringOcena 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:
|
contentDetails.contentRating.mocRating |
stringOcena filmu przyznana przez Ministerio de Cultura (Kolumbia). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.moctwRating |
stringOcena filmu przyznana przez Ministerstwo Kultury Tajwanu (文化部). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mpaaRating |
stringOcena filmu przyznana przez Motion Picture Association of America (MPAA). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.mpaatRating |
stringOcena zwiastunów i zapowiedzi filmów przyznana przez Motion Picture Association of America. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mtrcbRating |
stringOcena 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:
|
contentDetails.contentRating.nbcRating |
stringOcena filmu przyznana przez malediwskie Krajowe Biuro Klasyfikacji. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.nfrcRating |
stringOcena filmu przyznana przez Bułgarskie Narodowe Centrum Filmowe. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.nfvcbRating |
stringOcena filmu przyznana przez nigeryjską National Film and Video Censors Board. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.nkclvRating |
stringOcena filmu przyznana przez Nacionãlais Kino centrs (Narodowe Centrum Filmowe Łotwy). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.oflcRating |
stringOcena filmu przyznana przez nowozelandzki urząd ds. klasyfikacji filmów i literatury (OFLC). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.pefilmRating |
stringOcena filmu w Peru. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.resorteviolenciaRating |
stringOcena filmu w Wenezueli. Prawidłowe wartości tego pola to:
|
contentDetails.contentRating.rtcRating |
stringOcena filmu przyznana przez Generalną Dyrekcję ds. Radia, Telewizji i Kinematografii (Meksyk). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.rteRating |
stringOcena filmu przyznana przez irlandzką stację Raidió Teilifís Éireann. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.russiaRating |
stringOcena filmu w rejestrze filmów Narodowego Funduszu Filmowego Federacji Rosyjskiej (MKRF – Rosja). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.skfilmRating |
stringOcena filmu w Słowacji. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.smaisRating |
stringOcena filmu w Islandii. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.smsaRating |
stringOcena filmu przyznana przez Statens medieråd (szwedzką Radę ds. Mediów). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.tvpgRating |
stringOcena treści wideo zgodnie z wytycznymi TV Parental Guidelines (TVPG). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.ytRating |
stringOcena, której YouTube używa do identyfikowania treści z ograniczeniem wiekowym. Prawidłowe wartości tej właściwości to:
|
contentDetails.projection |
stringOkreśla format projekcji filmu. Prawidłowe wartości tej właściwości to:
|
contentDetails.hasCustomThumbnail |
booleanOkreś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 |
objectObiekt status zawiera informacje o stanie przesyłania, przetwarzania i prywatności filmu. |
status.uploadStatus |
stringStan przesłanego filmu. Prawidłowe wartości tej właściwości to:
|
status.failureReason |
stringTa 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:
|
status.rejectionReason |
stringTa 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:
|
status.privacyStatus |
stringStan prywatności filmu. Prawidłowe wartości tego atrybutu to:
|
status.publishAt |
datetimeData 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:
|
status.license |
stringLicencja filmu. Prawidłowe wartości tego pola to:
|
status.embeddable |
booleanTa wartość wskazuje, czy film można umieścić w innej witrynie. |
status.publicStatsViewable |
booleanTa 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 |
booleanTa 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 |
booleanW żą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 |
booleanW 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:
|
statistics |
objectObiekt statistics zawiera statystyki dotyczące filmu. |
statistics.viewCount |
unsigned longLiczba 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 |
statistics.likeCount |
unsigned longLiczba użytkowników, którzy polubili film. |
statistics.dislikeCount |
unsigned longUwaga: 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 longUwaga: 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 longLiczba komentarzy do filmu. |
paidProductPlacementDetails |
objectObiekt paidProductPlacementDetails zawiera informacje o płatnym lokowaniu produktu w filmie. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanUstaw wartość true, jeśli w treściach występuje płatne lokowanie produktu. Domyślna wartość to false. |
player |
objectObiekt player zawiera informacje, które umożliwiają odtworzenie filmu w odtwarzaczu umieszczonym na stronie. |
player.embedHtml |
stringTag <iframe>, który osadza odtwarzacz odtwarzający film.
|
player.embedHeight |
longWysokość 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 |
longSzerokość 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 |
objectObiekt topicDetails zawiera informacje o tematach powiązanych z filmem.Ważne: definicje właściwości topicDetails.relevantTopicIds[] i topicDetails.topicIds[] oraz historię zmian znajdziesz w artykule o nadchodzących zmianach związanych z identyfikatorami tematów. |
topicDetails.topicIds[] |
listWaż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[] |
listLista 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[] |
listLista adresów URL Wikipedii, które zawierają ogólny opis treści filmu. |
recordingDetails |
objectObiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie, pod którym nagrano film. |
recordingDetails.locationDescription |
stringTa 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 |
objectTa 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 |
doubleTa 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 |
doubleTa 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 |
doubleTa 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 |
datetimeData i godzina nagrania filmu. Wartość jest podana w formacie ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ). |
fileDetails |
objectObiekt 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 |
stringNazwa przesłanego pliku. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku. |
fileDetails.fileSize |
unsigned longRozmiar przesłanego pliku w bajtach. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku. |
fileDetails.fileType |
stringTyp 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:
|
fileDetails.container |
stringFormat kontenera przesłanego pliku wideo. |
fileDetails.videoStreams[] |
listLista 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 integerSzerokość zakodowanej treści wideo w pikselach. Współczynnik proporcji kodowania filmu możesz obliczyć jako width_pixels / height_pixels. |
fileDetails.videoStreams[].heightPixels |
unsigned integerWysokość zakodowanej treści wideo w pikselach. |
fileDetails.videoStreams[].frameRateFps |
doubleLiczba klatek na sekundę w strumieniu wideo. |
fileDetails.videoStreams[].aspectRatio |
doubleFormat obrazu treści wideo, który określa, w jakim formacie obrazu film powinien być wyświetlany. |
fileDetails.videoStreams[].codec |
stringKodek wideo używany przez strumień. |
fileDetails.videoStreams[].bitrateBps |
unsigned longSzybkość transmisji strumienia wideo w bitach na sekundę. |
fileDetails.videoStreams[].rotation |
stringWartość, 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:
|
fileDetails.videoStreams[].vendor |
stringWartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy. |
fileDetails.audioStreams[] |
listLista strumieni audio zawartych w przesłanym pliku wideo. Każdy element listy zawiera szczegółowe metadane strumienia audio. |
fileDetails.audioStreams[].channelCount |
unsigned integerLiczba kanałów audio, które zawiera strumień. |
fileDetails.audioStreams[].codec |
stringKodek audio używany przez strumień. |
fileDetails.audioStreams[].bitrateBps |
unsigned longSzybkość transmisji strumienia audio w bitach na sekundę. |
fileDetails.audioStreams[].vendor |
stringWartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy. |
fileDetails.durationMs |
unsigned longDł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 |
stringData i godzina utworzenia przesłanego pliku wideo. Wartość jest podana w formacie ISO 8601. Obecnie obsługiwane są te formaty ISO 8601:
|
processingDetails |
objectObiekt 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 |
stringStan 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:
|
processingDetails.processingProgress |
objectObiekt 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 longSzacowana łą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 longLiczba 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_totalPamię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 longSzacowany czas w milisekundach, jaki YouTube potrzebuje na zakończenie przetwarzania filmu. |
processingDetails.processingFailureReason |
stringPrzyczyna, 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:
|
processingDetails.fileDetailsAvailability |
stringTa 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 |
stringTa 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 |
stringTa 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 |
stringTa 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 |
stringTa wartość wskazuje, czy dla filmu wygenerowano miniatury. |
suggestions |
objectObiekt 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[] |
listLista 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:
|
suggestions.processingWarnings[] |
listLista 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:
|
suggestions.processingHints[] |
listLista sugestii, które mogą poprawić możliwości przetwarzania filmu przez YouTube. Prawidłowe wartości tej właściwości to:
|
suggestions.tagSuggestions[] |
listLista 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 |
stringTag słowa kluczowego sugerowany dla filmu. |
suggestions.tagSuggestions[].categoryRestricts[] |
listZbió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[] |
listLista 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:
|
liveStreamingDetails |
objectObiekt 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 |
datetimeGodzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po rozpoczęciu transmisji. |
liveStreamingDetails.actualEndTime |
datetimeCzas rzeczywistego zakończenia transmisji. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji. |
liveStreamingDetails.scheduledStartTime |
datetimeZaplanowana godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetimeGodzina, 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 longLiczba 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 |
stringIdentyfikator 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 |
objectObiekt brandPartner zawiera szczegóły dotyczące marki powiązanej z filmem w ramach dostępu marki inicjowanego przez twórcę (CI BPA). |
brandPartner.channelId |
stringZewnę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 |
stringNick 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 |
objectObiekt localizations zawiera tłumaczenia metadanych filmu. |
localizations.(key) |
objectJę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 |
stringZlokalizowany tytuł filmu. |
localizations.(key).description |
stringZlokalizowany opis filmu. |