Uwaga: nowy przewodnik Przestrzeganie zasad YouTube dla deweloperów zawiera wskazówki i przykłady, które pomogą Ci zadbać o to, by Twoje klienty interfejsu API były zgodne z konkretnymi częściami Warunków i Zasad interfejsu API YouTube. Ten przewodnik zawiera informacje o tym, jak YouTube egzekwuje niektóre aspekty Warunków korzystania z interfejsu API, ale nie zastępuje istniejących dokumentów.
Ten dokument określa minimalne wymagania funkcjonalne dla klientów API, którzy implementują lub udostępniają określone funkcje usług API YouTube („Klienty API”).
Dzięki tym wymaganiom i wytycznym klienty interfejsu API zapewniają spójne wrażenia użytkowników, które chronią interesy użytkowników YouTube, właścicieli treści i reklamodawców. Te reguły stanowią integralną część Warunków korzystania z interfejsu YouTube API, które należy przestrzegać podczas opracowywania i wdrażania klientów API.
Możesz się spodziewać zmian w tym dokumencie, abyśmy mogli zapewnić użytkownikom lepsze wrażenia z korzystania z dotychczasowych funkcji YouTube. Zmienią się również w odpowiedzi na nowe i zaktualizowane funkcje YouTube. Czasami wprowadzenie takich zmian może wymagać zaktualizowania klientów interfejsu API, aby spełniały nowe wymagania. Historia zmian Warunków korzystania z usługi dokumentuje wszelkie zmiany, dlatego często sprawdzaj ten dokument lub zasubskrybuj kanał RSS, aby mieć szybki dostęp do informacji o zmianach, które mogą mieć wpływ na Twoje klienty interfejsu API.
Oprócz wymagań podanych w tym dokumencie zalecamy również stosowanie sprawdzonych metod opisanych w Zasadach korzystania z usług YouTube API, które zostały opisane w dokumentacji usług YouTube API. Te metody, nawet jeśli nie są ściśle wymagane, ułatwiają klientom korzystającym z interfejsów API szybsze naprawianie błędów i optymalizację wykorzystania limitów, jeśli korzystają z YouTube API, które obsługują limit. Jednocześnie te praktyki mają na celu utrzymanie dobrego stanu ekosystemu YouTube, a przede wszystkim zapewnienie użytkownikom wygody korzystania z interfejsów API i aplikacji YouTube.
Odtwarzacz YouTube i odtwarzanie filmów
Wymagania w tej sekcji dotyczą szczególnie odtwarzaczy YouTube umieszczonych na stronie. Zasady dotyczące usług interfejsu API YouTube obejmują również kilka zasad dotyczących klientów interfejsu API obsługujących treści audiowizualne YouTube.
Rozmiar umieszczonego odtwarzacza YouTube
Odtwarzacz umieszczony na stronie musi mieć okno wyświetlania o rozmiarze co najmniej 200 x 200 pikseli. Jeżeli w odtwarzaczu mają być widoczne elementy sterujące, musi on być na tyle duży, aby elementy te były całkowicie widoczne bez zmniejszania okna wyświetlania poniżej rozmiaru minimalnego. W przypadku odtwarzaczy 16:9 zalecamy rozmiar co najmniej 480 pikseli szerokości i 270 pikseli wysokości.
Autoodtwarzanie i odtwarzanie według scenariusza
Ta sekcja dotyczy automatycznego odtwarzania. Dotyczy to umieszczonych na stronie odtwarzaczy YouTube, które używają parametru odtwarzacza autoplay, albo automatycznie uruchamiają automatyczne odtwarzanie przy użyciu usługi YouTube IFrame Player API, usługi YouTube Android Player API lub innej usługi YouTube API.
-
Umieszczone odtwarzacze, które automatycznie odtwarzają filmy, powinny rozpocząć odtwarzanie od razu po wczytaniu strony lub natychmiast, gdy odtwarzacz jest w pełni widoczny. Klient API nie może jednak uruchomić automatycznego odtwarzania, dopóki odtwarzacz nie będzie widoczny, a ponad połowa odtwarzacza nie będzie widoczna na stronie lub ekranie.
-
Strona lub ekran nie mogą mieć więcej niż jednego odtwarzacza YouTube, który automatycznie odtwarza treści jednocześnie.
-
Każda miniatura YouTube, która inicjuje odtwarzanie, musi mieć co najmniej 120 pikseli szerokości i 70 pikseli wysokości.
Atrybuty odtwarzacza YouTube
Atrybuty i parametry odtwarzacza YouTube, w tym na przykład jego logo, są określone w dokumentacji i specyfikacji interfejsu API YouTube (https://developers.google.com/youtube). Nie możesz wprowadzać zmian w odtwarzaczu YouTube, który nie został jednoznacznie opisany w dokumentacji interfejsu API.
Nakładki i ramki
Nie można wyświetlać nakładek, ramek ani innych elementów wizualnych przed żadną częścią umieszczonego odtwarzacza YouTube, w tym elementami sterującymi odtwarzaczem. Nie można też zakrywać żadnej części umieszczonego odtwarzacza, w tym elementów sterujących odtwarzaczem ani innych elementów wizualnych.
Przesunięcia kursora myszy
Użytkownik nie może wykonywać działań w imieniu użytkownika za pomocą ruchu kursora myszy ani zdarzeń dotyku, np. otwierania okna czy subskrybowania kanału.
Przesyłanie filmów wideo
Jeśli klienty interfejsu API umożliwiają użytkownikom przesyłanie treści na wiele platform, użytkownicy powinni mieć możliwość wyboru platform, na które chcą przesyłać filmy, i odznaczenia tych platform.
Wymagania dotyczące danych
Klienty interfejsu API, które umożliwiają użytkownikom przesyłanie filmów do YouTube, muszą umożliwiać użytkownikom ustawianie wartości na poniższej liście. Właściwości, które nie są wymienione na liście, są opcjonalne.
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobów | ||
snippet.title |
Required. Tytuł filmu. YouTube zwraca błąd, jeśli wartość przekracza 100 znaków. YouTube obsługuje wszystkie prawidłowe znaki UTF-8 oprócz < i >.
| |
snippet.description |
Required. Opis filmu. YouTube zwraca błąd, jeśli wartość przekracza 5000 bajtów. YouTube obsługuje wszystkie prawidłowe znaki UTF-8 oprócz < i >. |
|
status.privacyStatus |
Required. Ustawienia prywatności filmu. Użytkownicy muszą mieć możliwość określenia, czy przesłany film ma być publiczny, prywatny czy niepubliczny. | |
| Parametry żądania | ||
onBehalfOfContentOwnerChannel |
Wymagany warunkowo. Jeśli dane logowania w żądaniu autoryzacji wskazują właściciela treści i ustawiony jest parametr onBehalfOfContentOwner, użytkownik interfejsu API musi mieć możliwość określenia kanału YouTube, na który przesyłany jest film. |
|
Wyświetlanie komentarzy
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobów | ||
snippet.textDisplay |
Required. Tekst komentarza. Klient interfejsu API musi: (a) wyświetlać pełny tekst komentarza lub odpowiedzi na komentarz albo (b) skrócić tekst i umożliwić użytkownikowi łatwy dostęp do całego tekstu w wersji skróconej. To wymaganie dotyczy wszystkich komentarzy i odpowiedzi na komentarze, niezależnie od tego, jaki typ zasobów jest powiązany z filmami (kanałami, kanałami itp.). Pamiętaj, że wartość zasobu snippet.topLevelComment to właściwość comment i właściwości replies.comments[]. W związku z tym wymaganie dotyczy również usług snippet.topLevelComment.snippet.textDisplay i replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Wymagane (sugestia). Tytuł kanału
|
|
snippet.title( video) |
Wymagany warunkowo (sugestia). Tytuł filmu. Ta wartość musi być wyświetlana, jeśli komentarz dotyczy filmu. | |
snippet.moderationStatus |
Wymagany warunkowo. Jeśli wartość parametru moderationStatus w żądaniu do interfejsu API to heldForReview lub likelySpam, wyświetlacz musi wyraźnie identyfikować ten stan za pomocą wartości właściwości, podobnego języka (np. „Ten komentarz oczekuje na sprawdzenie”), nagłówka (np. „Do sprawdzenia”) lub innego niejednoznacznego języka. Metoda commentThreads.list obsługuje możliwość pobierania komentarzy na podstawie ich stanu moderacji. |
|
Dodawanie komentarzy
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobów | ||
snippet.title( channel) |
Required. Tytuł kanału
|
|
snippet.title( video) |
Required. Jeśli użytkownik dodaje komentarz na temat filmu, klient interfejsu API musi wyświetlić jego tytuł. | |
| Inne wymagania | ||
Comment author's channel name |
Required. Klient interfejsu API musi wyraźnie identyfikować konto użytkownika YouTube, do którego zostanie przypisany komentarz Jeśli dane logowania w żądaniu autoryzacji wskazują właściciela treści i ustawiony jest parametr onBehalfOfContentOwner, użytkownik interfejsu API musi mieć możliwość określenia kanału YouTube, do którego zostanie przypisany komentarz. |
|
Dodawanie odpowiedzi na komentarze
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobów | ||
snippet.textDisplay |
Required. Tekst komentarza. Klient interfejsu API musi wyświetlać treść komentarza, na który użytkownik odpowiada, zgodnie z regułami określonymi w sekcji Wyświetlanie komentarzy tego dokumentu. | |
snippet.title( channel) |
Required. Tytuł kanału
|
|
snippet.title( video) |
Required. Jeśli użytkownik odpowiada na komentarz do filmu, klient interfejsu API musi wyświetlić jego tytuł. | |
| Inne wymagania | ||
Comment author's channel name |
Required. Klient interfejsu API musi wyraźnie identyfikować konto użytkownika YouTube, do którego zostanie przypisana odpowiedź na komentarz. Jeśli dane logowania w żądaniu identyfikują właściciela treści i ustawiony jest parametr onBehalfOfContentOwner, użytkownik interfejsu API musi mieć możliwość określenia kanału YouTube, do którego zostanie przypisana odpowiedź na komentarz. |
|
Edytowanie i usuwanie odpowiedzi na komentarze
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobów | ||
snippet.textDisplay |
Required. Tekst komentarza. Klient interfejsu API musi wyświetlać tekst komentarza, który użytkownik edytuje lub usuwa zgodnie z regułami określonymi w sekcji Wyświetlanie komentarzy w tym dokumencie. | |
snippet.title( channel) |
Required. Tytuł kanału
|
|
snippet.title( video) |
Required. Jeśli użytkownik edytuje lub usuwa komentarz do filmu, klient interfejsu API musi wyświetlić jego tytuł. | |
| Inne wymagania | ||
Comment author's channel name |
Required. Klient interfejsu API musi wyraźnie identyfikować konto użytkownika YouTube, do którego przypisano komentarz. | |
blokowanie użytkownikom dostępu do czatu na żywo (lub usuwanie blokady).
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobów | ||
snippet.title( channel) |
Required. Nazwa kanału YouTube, który jest zablokowany lub zablokowany. Dodatkowo nazwa musi zawierać link do kanału lub musi być wyświetlany adres URL kanału. | |
| Inne wymagania | ||
| Skomentuj nazwę kanału autora | Required. Klient interfejsu API musi wyraźnie określić konto użytkownika YouTube, którego dotyczy blokada lub nałożenie blokady. | |