Video & sari kata · Pemuat Lakaran kecil YouTube & Pemapar Metadata
Cara oEmbed mengembalikan tajuk awam, saluran dan kod benam
· Bagaimana ia berfungsi
youtube oembed metadata
Terdapat cara standard tanpa kunci untuk meminta tapak video untuk tajuk awam, pengarang dan benam HTML. Siaran ini menerangkan oEmbed, rupa permintaan dan respons dan cara alat boleh menunjukkan metadata tanpa mengikis halaman.
Tajuk dan saluran tanpa memuatkan halaman — soalan yang direka bentuk untuk dijawab oleh oEmbed
Seorang blogger boleh mempelajari tajuk dan saluran semasa video awam tanpa memuatkan halaman tontonan. ToolAcre meminta titik akhir oEmbed YouTube untuk rekod JSON berstruktur sahaja selepas pelawat menekan Ambil secara eksplisit. Urutan itu juga menghalang carian metadata yang gagal daripada dikelirukan dengan URL yang cacat, kerana kedua-dua peringkat mempunyai bukti yang berbeza.
Pautan dihuraikan terlebih dahulu dalam pelayar. Prapenerbangan itu mengesahkan dan mengekstrak ID tanpa akses rangkaian, menjauhkan input yang salah bentuk daripada hos lakaran kecil dan titik akhir metadata. Titik akhir membekalkan perwakilan awam yang sempit, bukan suapan data tujuan umum atau mekanisme kebenaran.
Apa itu oEmbed — standard kecil di mana tapak menerbitkan titik akhir yang menjawab 'terangkan ini URL' dengan JSON
oEmbed ialah konvensyen permintaan dan respons untuk menerangkan URL awam. Di sini, YouTube menyediakan titik akhir yang menerima video URL dan mengembalikan JSON medan yang bertujuan untuk pembenaman dan atribusi. Pertanyaan tepat berguna dalam surih Rangkaian kerana ia menunjukkan sumber berkanun yang diminta tanpa mendedahkan bukti kelayakan akaun.
ToolAcre menganggap titik akhir itu sebagai siling dan bukannya pintu untuk mengikis. Ia tidak memeriksa halaman tontonan HTML, perkhidmatan youtubei dalaman, tandatangan atau apa-apa sahaja yang tidak dapat dicapai oleh permintaan awam yang dilog keluar. Medan boleh hadir dalam JSON mentah dan masih sengaja ditinggalkan daripada kontrak permohonan, jadi normalisasi ialah keputusan produk. Itu mengekalkan nota hiliran daripada bergantung pada penambahan huluan yang tidak disengajakan.
Permintaan — video URL dan parameter format, tidak lebih, dihantar ke youtube.com
Permintaan pergi ke https://www.youtube.com/oembed dengan url ditetapkan kepada nilai https://www.youtube.com/watch?v=ID kanonik dan format ditetapkan kepada json. Tiada kunci API, kuki log masuk atau token akaun ditambahkan. Hasil yang kosong adalah akibatnya pemerhatian sempadan, bukan bukti bahawa pengecam itu tidak sah atau data yang dilindungi harus dicuba semula.
Pelayar menghantar GET tanpa nama dengan bukti kelayakan ditinggalkan, tiada perujuk, caching tanpa kedai dan ubah hala yang diikuti. Google menerimanya dan pengepala Asalnya secara langsung; ToolAcre tidak mengendalikan pelayan atau proksi dalam laluan itu. Ini memastikan eksport stabil apabila muatan huluan mengandungi medan tambahan yang tidak dijanjikan oleh alat itu untuk disimpan.
Respons yang dinormalkan mendedahkan medan metadata, bukan oEmbed HTML
Garis besar yang dijanjikan dipaparkan benam HTML, tetapi normalizeOembed sengaja meninggalkan medan itu. Objek yang dinormalkan mengandungi tajuk, saluran, saluran URL, lakaran kecil URL dan dimensi, lebar dan tinggi pemain, pembekal dan ID video. Mengelaskan kegagalan secara berasingan membantu pengguna memutuskan sama ada untuk mencuba semula, memeriksa respons atau memilih sumber lain yang dibenarkan.
Setiap nilai dipertahankan: teks yang hilang mendapat sandaran biasa, dimensi mestilah positif dan pautan mestilah HTTPS. Ini menjadikan JSON yang dieksport boleh diramal tanpa membayangkan bahawa setiap sifat oEmbed mentah dipaparkan. Permintaan boleh diperiksa dalam DevTools, tetapi rekod pelayar tidak membayangkan storan oleh ToolAcre atau pemprosesan tempatan sahaja.
Mengapa tiada kunci atau log masuk diperlukan — data sudah terbuka di halaman; oEmbed sahaja menjadikannya berstruktur
Tiada kunci diperlukan kerana ini adalah metadata awam yang dilog keluar, tetapi awam tidak bermaksud universal. Video peribadi, dipadamkan dan sekatan umur tidak menyediakan rekod, manakala pemilik yang melumpuhkan pembenaman boleh menyebabkan respons keizinan. Oleh itu, penerbit yang menyemak permintaan yang gagal harus menyemak ketersediaan benam dan keterlihatan video daripada menganggap ID sebelas aksara telah dihuraikan secara tidak betul.
Sempadan ketiadaan adalah eksplisit: tiada tontonan, suka, perihalan, teg, tempoh, tarikh penerbitan atau kapsyen disintesis. Titik akhir tanpa kunci tidak memberikan akses melebihi apa yang YouTube pilih untuk diterbitkan. Jika hamparan editorial memerlukan medan yang ditinggalkan itu, pengarangnya mesti menggunakan sumber lain yang dibenarkan dan melabelkan sumber itu dan bukannya membentangkan tempat kosong sebagai data oEmbed.
Contoh yang berjaya: memetakan oEmbed JSON ke dalam rekod normal ToolAcre
Untuk satu muatan yang berjaya, tajuk dipetakan ke tajuk, nama_pengarang untuk disalurkan, pengarang_url ke URL saluran, medan lakaran kecil ke perihalan imej bersarang dan lebar dan tinggi kepada dimensi pemain. nama_pembekal menjadi pembekal. Pemetaan ini memberikan eksport nama aplikasi yang stabil walaupun konvensyen huluan menggunakan istilah pengarang untuk saluran YouTube.
HTML mentah mungkin terdapat di hulu, tetapi hasil ToolAcre dan eksport tidak mendedahkannya. Apl secara berasingan membina iframe dipertingkat privasi responsifnya sendiri daripada ID yang disahkan, mengelakkan kepercayaan tidak sengaja dalam penanda titik akhir. Pengguna menerima fakta yang mereka boleh sebutkan atau sirikan, manakala penanda benam boleh laku kekal di luar kontrak metadata yang dinormalkan.
Perkara yang tidak meliputi perkara ini — kiraan paparan, penerangan, ulasan, kapsyen dan apa-apa sahaja di sebalik log masuk
Percubaan metadata boleh gagal sebelum respons kerana mod luar talian, penyekat atau proksi; ia boleh gagal melalui status HTTP; atau ia boleh mengembalikan status kejayaan dengan JSON yang tidak sah. Setiap laluan menerima mesej yang berbeza. Ralat pengangkutan mencadangkan menyemak persekitaran pelayar, manakala JSON yang tidak sah mengenal pasti respons yang tiba tetapi tidak dapat memenuhi format yang dijanjikan oleh titik akhir.
Penyelidikan lakaran kecil adalah bebas dan mungkin melihat 404, ralat lain, pemegang tempat 200 atau data tidak boleh dikod. Cawangan tidak memuat turun video atau memintas sekatan untuk kandungan peribadi, dipadamkan atau sekatan umur. Mengekalkan cawangan bebas membolehkan editor mengekalkan poster yang disahkan walaupun atribusi tajuk tidak tersedia buat sementara waktu, tanpa mencipta metadata yang hilang.
Metadata awam berstruktur tanpa memaparkan benaman titik akhir HTML
Hasilnya ialah metadata awam berstruktur, bukan salinan oEmbed HTML sewenang-wenangnya. ToolAcre boleh mengeksport fakta ternormal sebagai JSON, Markdown, CSV atau teks dan boleh membina pautan yang diketahui daripada pengecam yang disahkan. Pilihan eksport mengubah persembahan, bukan skop: setiap format mencerminkan tajuk, saluran, imej, pemain, pembekal dan rekod ID yang sama.
Selepas Ambil, trafik terdiri daripada permintaan imej i.ytimg.com langsung dan satu permintaan oEmbed berkanun. Permintaan meninggalkan bukti kelayakan dan perujuk, menggunakan ubah hala tanpa kedai dan diikuti, dan kekal kelihatan untuk pengesahan dalam panel Rangkaian pelayar. Jejak itu membuktikan pelayar menghubungi Google secara langsung; ia tidak menunjukkan ToolAcre menyimpan carian dan ia juga tidak menjadikan operasi setempat.