ඔබ Spotify, Google සහ GitHub ගිණුම් තුනක්ම සකසා තිබේද? එසේ නම්, YouTube ගීත ලැයිස්තුවක් Spotify වෙත සින්ක් කිරීමේ කාර්යය ඇරඹීමට සූදානම්! මෙම ලිපියේ අපි Spotify Developer ඇප් එකක් නිර්මාණය කර, අවශ්ය CLIENT_ID, CLIENT_SECRET, REFRESH_TOKEN තුනක් ලබා ගන්නේ කෙසේද කියලා පියවරෙන් පියවර කියනවා.
පළමුව developer.spotify.com වෙත ගොස්, ඔබේ සාමාන්ය Spotify ගිණුමෙන් ලොග් වෙන්න. පසුකාලීනව, වම්පැත්තේ ප්රොෆයිල් නාමය ක්ලික් කර Dashboard තෝරන්න. එතැනින් “My Apps” පිටුවේ Create app බොත්තම ඔබා, නව ඇප් එකක් සාදන්න.
ඇප් පෝරමය පුරවන්න: App name ලෙස “youtube-to-spotify” වැනි විස්තරාත්මක නාමයක්, App description ලෙස “Syncs a YouTube playlist to Spotify.” වචනයක්, සහ Redirect URI ලෙස http://127.0.0.1:8888/callback ඇතුළත් කරන්න. Web API කොටස තෝරා, නියමයන් අනුමත කර Save කරන්න. මෙයින් ඔබේ ඇප් සාර්ථකව නිර්මාණය වේ.
ඉදිරියට, ඇප් සැකසුම් පිටුවේ Client ID සහ Client Secret නිරීක්ෂණය කරන්න. Client ID එක තාක්ෂණික අක්ෂර-අංක ගොනුවක්, Client Secret එක පාරිභෝගික මුරපදයක් වගේ. ඒ දෙකම ආරක්ෂිත තැනක (නෝට්ස් ඇප්, ටෙක්ස්ට් ෆයිල්) සුරකින්න; ඉදිරි කේතයේ Chapter 5 වලදී ඒවා භාවිතා කරමු.
අවසන් පියවර – Refresh Token ලබා ගැනීම. මෙය ස්ක්රිප්ට් එකට දිගුකාලීන අවසර ලබා දෙන “ඔන්ලයින් ලොග් ඉන්” එකක්. පළමුව, පහත URL එකේ YOUR_CLIENT_ID වෙනුවට ඔබේ Client ID එක තබා බ්රවුසරයේ ඇතුළත් කරන්න:
https://accounts.spotify.com/authorize?client_id=YOUR_CLIENT_ID&response_type=code&redirect_uri=http://127.0.0.1:8888/callback&scope=playlist-modify-public%20playlist-modify-private
ලොග් ඉන් කර, “Agree” බොත්තම ඔබන්න. බ්රවුසරය http://127.0.0.1:8888/callback වෙත යාමට උත්සාහ කරයි, නමුත් එය “site can't be reached” කියලා පෙන්වයි – එය සාමාන්යය. එවිට URL බාර් එකේ ?code= පසු ඇති දිගු අකුරු මාලාව (authorization code) පිටපත් කර ගන්න.
දැන්, එම කේතය curl හෝ වෙනත් HTTP client එකක් භාවිතා කර, Token Endpoint වෙත POST කර, Refresh Token එක ලබා ගන්න. Windows හි Command Prompt, macOS/Linux හි Terminal තුළ පහත කමාණ්ඩය ක්රියාත්මක කරන්න (YOUR_CLIENT_ID, YOUR_CLIENT_SECRET, YOUR_CODE වෙනුවට ඔබේ අගයන් තබා):
curl -X POST https://accounts.spotify.com/api/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code" \
-d "code=YOUR_CODE" \
-d "redirect_uri=http://127.0.0.1:8888/callback" \
-u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"
ඒ ප්රතිඵලයෙන් refresh_token එක ලබා ගන්න. මේක ඔබේ ස්ක්රිප්ට් එකේ පරිසර විචල්ය (environment variable) ලෙස සුරකින්න; එවිට GitHub Actions හෝ අනෙකුත් CI/CD පද්ධති වලින් දිගු කාලීනව Spotify API භාවිතා කළ හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
Spotify API සහ YouTube API එකතු කරමින් ගීත ලැයිස්තු ස්වයංක්රීය කිරීම, ශ්රී ලංකාවේ තරුණ සංවර්ධකයන්ට වඩාත් ප්රායෝගික AI/Automation පළපුරුද්ද ලබා දේ. පාඨමාලා, වර්ක්ෂොප්, හොබ්බි ප්රොජෙක්ට් වලදී මෙය real‑world project එකක් ලෙස භාවිතා කළ හැක.
- ඉගෙනුම: OAuth 2.0, REST API, curl භාවිතය යන තාක්ෂණික මූලධර්මයන් අත්හදා බැලීම.
- ව්යාපාරික ප්රයෝජනය: සංගීත සෙවීමේ සේවා, ප්රචාරක ඇප්, හෝ ප්රසිද්ධිය වැඩිදියුණු කිරීමේ අරමුණින් ගීත ලැයිස්තු සින්ක් කිරීමේ සේවා ලබා දීමට හැකියාව.
- දේශීය සමාජය: සිංහල, තමිල්, මුලතිව් ගීතයන් Spotify වෙත ආරෝපණය කිරීමේදී භාෂා ගැලපීම හා සංස්කෘතික ප්රචාරය ඉහළ යයි.
අවසන් වශයෙන්, ඔබේ Spotify Developer ඇප් එක සකසා, Client ID, Client Secret, Refresh Token ලබා ගත් පසු, ඉදිරියේදී Python, Node.js හෝ GitHub Actions භාවිතා කර YouTube ලැයිස්තු ස්වයංක්රීයව Spotify වෙත සින්ක් කරන කේතය ලියන්න. මේක ඔබේ පෞද්ගලික automation ව්යාපෘතියක් වශයෙන් හෝ open‑source ප්රොජෙක්ට් එකක් ලෙස හවුලට ගෙන ඒමට හොඳ ආරම්භයක්.
ඔබත් මේ පියවර අනුගමනය කර, ඔබේ සංගීත ලැයිස්තු කාර්යයන් තවත් පහසු කරගන්න. සාර්ථකත්වය ඔබේ අතේ!
