YouTube permite miniaturi personalizate pentru Shorts prin API

YouTube a extins pe 3 noiembrie API-ul de publicare pentru a accepta miniaturi personalizate la Shorts. Aplicațiile conectate pot trimite o imagine de copertă după finalizarea procesării videoclipului. Actualizarea adaugă și o variantă verticală a miniaturii în datele returnate de YouTube. Schimbarea privește instrumentele prin care echipele de conținut își gestionează publicarea pe canal.

Miniatura se atașează după procesarea videoclipului

Operațiunea thumbnails.set primește imaginea pentru un identificator de videoclip existent. În cazul unui Short, YouTube cere ca procesarea videoclipului să se fi încheiat cu succes. Dacă imaginea este transmisă înainte de acel moment, serviciul poate primi solicitarea fără să aplice miniatura clipului.

Proprietarul videoclipului poate citi stadiul procesării din datele asociate acestuia. Câmpul processingStatus din processingDetails poate arăta că procesarea continuă, că a eșuat, că s-a încheiat cu succes sau că informația nu mai este disponibilă. Valoarea succeeded este reperul indicat pentru atașarea imaginii la Shorts. Datele includ și estimări ale progresului, accesibile proprietarului în timpul procesării.

Metoda videos.list poate returna secțiunea de procesare pentru videoclipurile cerute prin identificator. Aplicația indică în solicitare ce secțiuni ale resursei vrea să primească. Aceeași metodă poate returna, după caz, date despre conținut și vizibilitate. Citirea resursei și trimiterea imaginii sunt operațiuni separate, fiecare cu propriul răspuns. O citire prin această metodă consumă o unitate din cota API.

Pentru transferurile întrerupte, API-ul acceptă încărcarea reluabilă. Serviciul indică starea incompletă prin răspunsul HTTP 308 și, când a primit o parte din fișier, trimite intervalul de octeți în antetul Range. Aplicația poate continua de la următorul octet. La încheierea cu succes a încărcării, răspunsul HTTP 201 include resursa videoclipului creat. Această confirmare furnizează identificatorul clipului, în timp ce starea de procesare se citește separat.

Formatul vertical și datele returnate de API

Resursa miniaturii include câmpul shortsAspectRatio pentru un Short cu imagine personalizată. Acesta descrie varianta în raportul 9:16, cu adresa imaginii și câmpuri pentru lățime și înălțime. Referința API precizează că dimensiunile pot lipsi din răspuns. YouTube decupează miniatura unui Short la proporția verticală, în cadrul procesării imaginii trimise.

Încadrarea videoclipului folosește propriile criterii. Pentru canalele obișnuite, YouTube clasifică drept Shorts videoclipurile pătrate sau verticale de cel mult trei minute, încărcate începând cu 15 octombrie 2024. Pentru canalele oficiale ale artiștilor și canalele asociate unui proprietar de conținut muzical, regula de clasificare corespunzătoare se aplică încărcărilor începând cu 8 decembrie 2025. Raportul 9:16 din actualizarea API privește imaginea de copertă, inclusiv când videoclipul clasificat drept Short este pătrat.

Limita documentată pentru imaginea transmisă prin thumbnails.set este de 50 MB. Metoda acceptă imagini JPEG și PNG. Un răspuns reușit include lista miniaturilor. Documentația indică răspunsuri distincte pentru conținut de imagine invalid, permisiuni insuficiente, identificator de videoclip negăsit și depășirea limitei de încărcări recente la nivel de canal.

YouTube oferă și încărcarea unei miniaturi Shorts din Studio pe calculator, pentru conturile verificate. Pentru această interfață, documentația recomandă imagini verticale de 2160 × 3840 pixeli și o înălțime minimă de 640 de pixeli. Aceste dimensiuni descriu pregătirea fișierului, iar proprietatea din API descrie varianta pe care o returnează platforma după atașare.

Schimbarea separată a vizibilității la încărcare

Pe 2 noiembrie, YouTube a retras restricția care impunea vizibilitatea privată pentru videoclipuri încărcate prin videos.insert din proiecte API neverificate. Regula data din 2020 și lega schimbarea vizibilității de auditarea proiectului. În comportamentul actual, când cererea omite setarea de confidențialitate, valoarea implicită este public, cu excepții determinate de setările contului creatorului.

YouTube păstrează cele trei stări de vizibilitate. Un videoclip public poate apărea în rezultatele căutării și în recomandări. Un videoclip nelistat poate fi văzut și redistribuit de cei care au adresa sa. Pentru un videoclip privat, accesul este limitat la proprietar și persoanele desemnate. În setările implicite ale conturilor creatorilor cu vârste de 13–17 ani, videoclipurile sunt private.

Publicarea programată păstrează videoclipul privat până la data și ora stabilite. YouTube Studio permite alegerea fusului orar pentru momentul programat. Pagina publică a videoclipului folosește timpul Pacific pentru data afișată, ceea ce poate produce o diferență de zi față de data văzută în Studio. În acest flux, momentul lansării și momentul terminării procesării rămân informații distincte.

Permisiuni de canal și cote separate

Încărcarea videoclipului prin API folosește o autorizare cu permisiuni de încărcare pentru cont. Pentru partenerii YouTube care gestionează mai multe canale prin sistemul de administrare a conținutului, metoda poate primi separat proprietarul și canalul țintă. Parametrul notifySubscribers controlează notificarea abonaților pentru noul videoclip și are implicit valoarea activată, conform referinței metodei de încărcare.

Cota implicită pentru videos.insert este de 100 de apeluri pe zi în categoria de încărcare a videoclipurilor. Un apel consumă o unitate din acea categorie. Celelalte operațiuni, în afara căutării care are și ea cotă proprie, împart limita implicită de 10.000 de unități pe zi. Metoda de încărcare a miniaturii are un cost de aproximativ 50 de unități pentru fiecare solicitare.

YouTube descrie încărcarea ca etapa în care fișierul ajunge în platformă și publicarea ca momentul în care videoclipul devine disponibil potrivit vizibilității alese. Pe parcurs, proprietarul poate primi rezultatele verificărilor de drepturi de autor înainte de lansare. Într-un flux de lucru care pregătește videoclipurile pentru mai multe canale, fiecare dintre aceste stări poate fi urmărită separat de confirmarea atașării miniaturii.