প্রয়োগ: ভিডিও

ভিডিও সম্পর্কিত ফাংশন পারফর্ম করার জন্য কীভাবে YouTube Data API (v3) ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণ থেকে জানতে পারবেন।

কোনও চ্যানেলের আপলোড করা ভিডিও ফিরিয়ে আনা

এই উদাহরণটি কোনও নির্দিষ্ট চ্যানেলে আপলোড করা ভিডিওগুলি ফিরিয়ে আনে। এই উদাহরণে দুটি ধাপ আছে:

  • ধাপ ১: চ্যানেলে আপলোড করা ভিডিওর জন্য প্লেলিস্ট আইডি সংগ্রহ করুন

    চ্যানেলের আপলোড করা ভিডিও থাকা প্লেলিস্টের আইডি পেতে channels.list মেথড কল করুন। অনুরোধের part প্যারামিটার ভ্যালুতে contentDetails অন্তর্ভুক্ত থাকতে হবে, যা channel রিসোর্স পার্টের মধ্যে একটি হিসেবে পুনরুদ্ধার করা হচ্ছে। API রেসপন্সে, contentDetails.relatedPlaylists.uploads প্রপার্টিতে প্লেলিস্ট আইডি থাকে।

    চ্যানেল শনাক্ত করার বিভিন্ন উপায় আছে:

  • ধাপ ২: আপলোড করা ভিডিওর তালিকা রিস্টোর করুন

    আপলোড করা ভিডিওর তালিকা পেতে playlistItems.list মেথড কল করুন। playlistId প্যারামিটারের ভ্যালু ধাপ ১-এ পাওয়া ভ্যালুতে সেট করুন। এই উদাহরণে, প্যারামিটারের ভ্যালু UUK8sQmJBp8GCxrOtXWBpyEA হিসেবে সেট করা হয়েছে, এটি হল Google-এর অফিসিয়াল YouTube চ্যানেলে আপলোড করা ভিডিওর তালিকা।

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.list?
        part=snippet,contentDetails,status
        &playlistId=UUK8sQmJBp8GCxrOtXWBpyEA

এই উদাহরণে দেখানো হয়েছে যে কীভাবে YouTube-এর সবচেয়ে জনপ্রিয় ভিডিওর তালিকা পাওয়া যায়। সামগ্রিক জনপ্রিয়তা নির্ধারণ করতে, বিভিন্ন ধরনের সিগন্যাল একত্রিত করে একটি অ্যালগরিদম ব্যবহার করে এই ভিডিওগুলি বেছে নেওয়া হয়।

সবচেয়ে জনপ্রিয় ভিডিওর তালিকা পেতে, videos.list মেথড কল করুন এবং chart প্যারামিটারের ভ্যালু mostPopular হিসেবে সেট করুন। mostPopular চার্টে জনপ্রিয় মিউজিক, সিনেমা ও গেমিং ভিডিও থাকে।

তারপর, আপনি চাইলে নিম্নলিখিত প্যারামিটার সেট করতে পারেন:

  • regionCode: নির্দিষ্ট অঞ্চলের ভিডিওর তালিকা দেখানোর জন্য API-কে নির্দেশ দেয়। প্যারামিটারের মান হল ISO 3166-1 alpha-2 দেশের কোড। YouTube-এ কাজ করে এমন অঞ্চল কোডের তালিকা পেতে আপনি i18nRegions.list পদ্ধতি ব্যবহার করতে পারেন।
  • videoCategoryId: ভিডিওর বিভাগ শনাক্ত করে যার জন্য সবচেয়ে জনপ্রিয় ভিডিও খুঁজে বের করতে হবে। YouTube-এ কাজ করে এমন বিভাগ আইডির তালিকা পেতে আপনি videoCategories.list পদ্ধতি ব্যবহার করতে পারেন।

যেমন, নিম্নলিখিত অনুরোধটি স্পেনের সবচেয়ে জনপ্রিয় স্পোর্টস ভিডিওগুলি ফিরিয়ে আনে:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
        part=snippet
        &chart=mostPopular
        &regionCode=es
        &videoCategoryId=17

ব্যাচ ভিডিও পরিসংখ্যান উদ্ধার করে

এই উদাহরণ videos.batchGetStats পদ্ধতি ব্যবহার করে ভিডিওর তালিকার পরিসংখ্যান ফিরিয়ে আনে।

এই পদ্ধতি ব্যবহার করতে, অনুরোধের id প্যারামিটারকে YouTube ভিডিও আইডির কমা দ্বারা আলাদা করা তালিকা হিসেবে সেট করুন, যেটির জন্য আপনি পরিসংখ্যান ফিরিয়ে আনতে চান। part প্যারামিটারের ভ্যালু videoStat রিসোর্সের সেইসব অংশকে কমা দিয়ে আলাদা করা তালিকার সাথে সেট করুন যেগুলি আপনি উত্তরের মধ্যে অন্তর্ভুক্ত করতে চান। যেসব অংশ কাজ করে সেগুলি হল snippet, statistics, contentDetails এবং id।

সর্বজনীন নয় এমন ভিডিওর ক্ষেত্রে এই পদ্ধতি ব্যবহার করতে যাচাইকরণ প্রয়োজন, তবে সর্বজনীন ভিডিওর ক্ষেত্রে প্রয়োজন নেই। অনুরোধটি যদি কোনও সর্বজনীন নয় এমন ভিডিওর জন্য ডেটা ফিরিয়ে আনে, তাহলে এটি অবশ্যই সঠিকভাবে অনুমোদিত হতে হবে।

নিচে দেওয়া অনুরোধটি ভিডিও আইডি VIDEO_ID_1 এবং VIDEO_ID_2-এর জন্য পরিসংখ্যান পুনরুদ্ধার করে:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.batchGetStats?
        part=snippet,statistics
        &id=VIDEO_ID_1,VIDEO_ID_2

ভিডিও আপলোড করুন

যেহেতু APIs Explorer-এ ফাইল আপলোড করার সুবিধা নেই, তাই এই বিবরণে এক্সিকিউটেবল উদাহরণের লিঙ্ক দেওয়া নেই। v3 API ব্যবহার করে ভিডিও আপলোড করার জন্য আপনার অ্যাপ্লিকেশন পরিবর্তন করতে, নিম্নলিখিত রিসোর্স আপনাকে সাহায্য করবে:

  • API-এর videos.insert পদ্ধতির ডকুমেন্টেশনে বিভিন্ন কোড স্যাম্পেল আছে যা থেকে বোঝা যায় যে বিভিন্ন প্রোগ্রামিং ল্যাঙ্গুয়েজ ব্যবহার করে কীভাবে ভিডিও আপলোড করতে হয়।

  • আবার শুরু করা যায় এমন আপলোড সংক্রান্ত নির্দেশিকায় HTTP অনুরোধের ক্রম ব্যাখ্যা করা হয়েছে যা আবার শুরু করা যায় এমন আপলোড প্রসেস ব্যবহার করে ভিডিও আপলোড করার জন্য কোনও অ্যাপ্লিকেশন ব্যবহার করে। এই গাইডটি মূলত সেইসব ডেভেলপারদের জন্য যারা Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারেন না, যার মধ্যে কিছু আবার রিজুম করা যায় এমন আপলোডের জন্য নেটিভ সাপোর্ট প্রদান করে।

  • ভিডিও আপলোড করার জন্য JavaScript উদাহরণটি CORS (ক্রস-অরিজিন রিসোর্স শেয়ারিং) ব্যবহার করে দেখায় যে কীভাবে ওয়েব পেজের মাধ্যমে ভিডিও ফাইল আপলোড করতে হয়। v3 API যে CORS আপলোড লাইব্রেরি ব্যবহার করে তা স্বাভাবিকভাবেই আপলোড করা আবার শুরু করার সুবিধা প্রদান করে। এছাড়াও, আপলোড করা ভিডিওর স্ট্যাটাস কীভাবে চেক করতে হয় তা উদাহরণে দেখানো হয়েছে। এর জন্য video রিসোর্সের processingDetails অংশটি ব্যবহার করা হয়েছে। পাশাপাশি, আপলোড করা ভিডিওর স্ট্যাটাস পরিবর্তন হলে তা কীভাবে ম্যানেজ করতে হয় তাও দেখানো হয়েছে।

আপলোড করা ভিডিওর স্ট্যাটাস চেক করা

আপলোড করা ভিডিওর স্ট্যাটাস কীভাবে চেক করতে হয় তা এই উদাহরণ থেকে জানতে পারবেন। আপলোড করা ভিডিওটি অবিলম্বে যাচাই করা ব্যবহারকারীর আপলোড করা ভিডিও ফিডে দেখা যাবে। তবে, প্রসেস না করা পর্যন্ত ভিডিওটি YouTube-এ দেখা যাবে না।

  • ধাপ ১: ভিডিও আপলোড করুন

    ভিডিও আপলোড করতে videos.insert পদ্ধতি কল করুন। অনুরোধটি সফল হলে, API রেসপন্সে একটি video রিসোর্স থাকবে যা আপলোড করা ভিডিওর জন্য অনন্য ভিডিও আইডি শনাক্ত করে।

  • ধাপ ২: ভিডিওর স্ট্যাটাস চেক করুন

    ভিডিওর স্ট্যাটাস চেক করতে videos.list মেথড কল করুন। ধাপ ১-এ পাওয়া ভিডিও আইডিতে id প্যারামিটারের ভ্যালু সেট করুন। part প্যারামিটারের ভ্যালু processingDetails-এ সেট করুন।

    অনুরোধটি সফলভাবে ম্যানেজ করা হলে, API রেসপন্সে একটি video রিসোর্স থাকবে। YouTube এখনও ভিডিওটি প্রসেস করছে কিনা তা নির্ধারণ করতে processingDetails.processingStatus প্রপার্টির ভ্যালু চেক করুন। YouTube ভিডিও প্রসেস করা হয়ে গেলে, প্রপার্টির ভ্যালু processing-এর পরিবর্তে succeeded বা failed-এর মতো অন্য কিছু হয়ে যাবে।

    অনুরোধের বডি হল একটি video রিসোর্স যেখানে id প্রপার্টি আপনি যে ভিডিওটি মুছছেন তার ভিডিও আইডি নির্দিষ্ট করে। এই উদাহরণে, রিসোর্সে একটি recordingDetails অবজেক্টও রয়েছে।

    নিচের অনুরোধটি একটি ভিডিওর স্ট্যাটাস চেক করে। APIs Explorer-এ অনুরোধ সম্পূর্ণ করতে, আপনাকে id প্রপার্টির ভ্যালু সেট করতে হবে।

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
        part=snippet,processingDetails
        &id=VIDEO_ID

মনে রাখবেন: আপনার অ্যাপ্লিকেশন, নতুন আপলোড করা ভিডিওর স্ট্যাটাস নিয়মিত চেক করার জন্য API পোল করতে পারে। ভিডিও প্রসেস করা হয়ে গেলে, আপনার আবেদন ভিডিওর স্ট্যাটাসের উপর নির্ভর করে বুলেটিন তৈরি করতে বা অন্য কোনও অ্যাকশন নিতে পারে।

ভিডিও আপডেট করা

এই উদাহরণে দেখানো হয়েছে যে কীভাবে ভিডিও রেকর্ড করা হয়েছে সেই সময় ও স্থান সম্পর্কিত তথ্য যোগ করতে ভিডিও আপডেট করতে হয়। উদাহরণে নিম্নলিখিত ধাপগুলি রয়েছে:

  • ধাপ ১: ভিডিও আইডি খুঁজে বের করা

    বর্তমানে যাচাই করা ব্যবহারকারীর চ্যানেলের জন্য আপলোড করা ভিডিও ফিরিয়ে আনতে উপরে উল্লেখ করা ধাপগুলি অনুসরণ করুন। প্রতিটি ভিডিওর আইডিকে কী হিসেবে ব্যবহার করে ভিডিওর তালিকা দেখানোর জন্য এই তালিকা ব্যবহার করা যেতে পারে।

    মনে রাখবেন: ভিডিও আইডি পাওয়ার আরও অনেক উপায় আছে, যেমন সার্চ ফলাফল থেকে খুঁজে নেওয়া বা প্লেলিস্টে আইটেম তালিকাভুক্ত করা। তবে, যেহেতু কোনও ভিডিও শুধুমাত্র তার মালিকই আপডেট করতে পারেন, তাই API অনুরোধ অনুমোদনকারী ব্যবহারকারীর মালিকানাধীন ভিডিওর তালিকা খুঁজে বের করা এই প্রক্রিয়ার প্রথম ধাপ হতে পারে।

  • ধাপ ২: ভিডিও আপডেট করা

    নির্দিষ্ট ভিডিও আপডেট করতে videos.update পদ্ধতি কল করুন। part প্যারামিটারের ভ্যালু recordingDetails-এ সেট করুন। (কোন ভিডিওর মেটাডেটা ফিল্ড আপডেট করা হচ্ছে তার উপর প্যারামিটারের ভ্যালু নির্ভর করে।)

    অনুরোধের বডিতে video রিসোর্স থাকে, যার মধ্যে id প্রপার্টিতে আপনি যে ভিডিও আপডেট করছেন তার ভিডিও আইডি উল্লেখ করা থাকে। এই উদাহরণে, রিসোর্সে একটি recordingDetails অবজেক্টও রয়েছে।

    নিচের স্যাম্পেল রিসোর্স থেকে বোঝা যায় যে ভিডিওটি ৩০ অক্টোবর, ২০১৩-এ বোস্টনে রেকর্ড করা হয়েছে:

    {
  "id": "VIDEO_ID",
  "recordingDetails": {
    "location": {
      "latitude": "42.3464",
      "longitude": "-71.0975"
    }
    "recordingDate": "2013-10-30T23:15:00.000Z"
  }
}

    API এক্সপ্লোরারে অনুরোধ সম্পূর্ণ করতে, আপনাকে id প্রপার্টির ভ্যালু সেট করতে হবে।

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=snippet

ক্রিয়েটরের শুরু করা ব্র্যান্ড পার্টনার অ্যাক্সেস (CI BPA) কোনও ভিডিওর মালিককে তার ভিডিওর অ্যাক্সেস কোনও ব্র্যান্ড পার্টনার চ্যানেলের সাথে শেয়ার করার অনুমতি দেয়। এর জন্য brandPartner অংশটি প্রয়োজন।

অ্যাক্সেস প্রতিষ্ঠা করা (যোগ করা)

ভিডিও আপলোড করার সময় অ্যাক্সেস সেট-আপ করতে, part প্যারামিটারে brandPartner অন্তর্ভুক্ত করুন এবং অনুরোধের বডিতে একটি brandPartner অবজেক্ট প্রদান করুন। ব্র্যান্ড চ্যানেল শনাক্ত করতে আপনাকে অবশ্যই channelId (এক্সটার্নাল চ্যানেল আইডি "UC" দিয়ে শুরু হয়) অথবা channelHandle ("@" দিয়ে শুরু হয়) উল্লেখ করতে হবে।

POST /youtube/v3/videos?part=snippet,status,brandPartner
{
  "snippet": {
    "title": "Video Title",
    "description": "Video Description",
    "categoryId": "22"
  },
  "status": {
    "privacyStatus": "private"
  },
  "brandPartner": {
    "channelHandle": "@brandchannel"
  }
}

উত্তরে শুধু সমাধান করা channelId ফেরত পাঠানো হবে।

অ্যাক্সেস আপডেট বা সরিয়ে দেওয়া (আপডেট)

অন্য কোনও ব্র্যান্ড চ্যানেলের অ্যাক্সেস আপডেট করতে বা অ্যাক্সেস সরাতে, part প্যারামিটারে brandPartner সহ videos.update মেথড কল করুন।

অ্যাক্সেস পরিবর্তন করতে, অনুরোধের বডিতে নতুন channelId বা channelHandle দিন:

PUT /youtube/v3/videos?part=brandPartner
{
  "id": "VIDEO_ID",
  "brandPartner": {
    "channelId": "UC_SOME_BRAND_CHANNEL_ID"
  }
}

অ্যাক্সেস সরাতে, part প্যারামিটারে brandPartner সহ একটি অনুরোধ পাঠান, তবে অনুরোধের বডিতে একটি খালি brandPartner অবজেক্ট সহ:

PUT /youtube/v3/videos?part=brandPartner
{
  "id": "VIDEO_ID",
  "brandPartner": {}
}

কাস্টম থাম্বনেল ছবি আপলোড করে কোনও ভিডিওর জন্য সেট করা

আপনি কাস্টম থাম্বনেল ইমেজ আপলোড করতে এবং কোনও ভিডিওর জন্য সেটি সেট করতে v3 API-এর thumbnails.set পদ্ধতি ব্যবহার করতে পারেন। আপনার অনুরোধে, videoId প্যারামিটারের মান সেই ভিডিওকে শনাক্ত করে যার জন্য থাম্বনেল ব্যবহার করা হবে।

এই কোয়েরি APIs Explorer ব্যবহার করে পরীক্ষা করা যাবে না কারণ APIs Explorer-এ মিডিয়া ফাইল আপলোড করার সুবিধা নেই, যা এই পদ্ধতির জন্য প্রয়োজন।

এই ধরনের কোড স্যাম্পেল: PHP, Python

ভিডিও মুছুন

এই উদাহরণে দেখানো হয়েছে কীভাবে ভিডিও মুছতে হয়। উদাহরণে নিম্নলিখিত ধাপগুলি রয়েছে:

  • ধাপ ১: ভিডিও আইডি সংগ্রহ করুন

    বর্তমানে যাচাই করা ব্যবহারকারীর চ্যানেলের জন্য আপলোড করা ভিডিও ফিরিয়ে আনতে উপরে উল্লেখ করা ধাপগুলি অনুসরণ করুন। প্রতিটি ভিডিওর আইডিকে কী হিসেবে ব্যবহার করে ভিডিওর তালিকা দেখানোর জন্য এই তালিকা ব্যবহার করা যেতে পারে।

    মনে রাখবেন: ভিডিও আইডি পাওয়ার আরও অনেক উপায় আছে, যেমন সার্চ ফলাফল থেকে পাওয়া বা প্লেলিস্টে আইটেম তালিকাভুক্ত করা। তবে, যেহেতু কোনও ভিডিও শুধুমাত্র তার মালিকই মুছে দিতে পারেন, তাই API অনুরোধ অনুমোদনকারী ব্যবহারকারীর মালিকানাধীন ভিডিওর একটি তালিকা পুনরুদ্ধার করা এই প্রক্রিয়ার একটি সম্ভাব্য প্রথম পদক্ষেপ।

  • ধাপ ২: ভিডিও মুছে দেওয়া

    নির্দিষ্ট কোনও ভিডিও মুছে দিতে videos.delete পদ্ধতি কল করুন। অনুরোধে, id প্যারামিটারটি আপনি যে ভিডিওটি মুছে ফেলছেন তার ভিডিও আইডি নির্দিষ্ট করে। অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। আপনি যদি APIs Explorer-এ এই কোয়েরি পরীক্ষা করেন, তাহলে আপনাকে id প্যারামিটার ভ্যালুর জন্য একটি সঠিক ভিডিও আইডি দিয়ে পরিবর্তন করতে হবে।

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.delete?
        id=VIDEO_ID

অপব্যবহারমূলক ভিডিও সম্পর্কে অভিযোগ জানানো

এই উদাহরণে দেখানো হয়েছে যে কীভাবে আপত্তিজনক কন্টেন্ট আছে এমন ভিডিও সম্পর্কে অভিযোগ জানাতে হয়। উদাহরণে নিম্নলিখিত ধাপগুলি রয়েছে:

  • ধাপ ১: ভিডিওর বিরুদ্ধে কেন অভিযোগ করা হচ্ছে তা ব্যাখ্যা করে এমন আইডি খুঁজে বের করুন

    ভিডিও ফ্ল্যাগ করার বৈধ কারণের তালিকা পেতে videoAbuseReportReasons.list পদ্ধতিতে অনুমোদিত অনুরোধ পাঠান। নিচে দেওয়া স্যাম্পেল videoAbuseReportReason রিসোর্সে স্প্যাম বা বিভ্রান্তিকর কন্টেন্ট আছে এমন ভিডিও ফ্ল্যাগ করার তথ্য আছে।

    {
  "kind": "youtube#videoAbuseReportReason",
  "etag": "\"tbWC5XrSXxe1WOAx6MK9z4hHSU8/Or2VqBIilpHU7j__oPzUFCvGVBw\"",
  "id": "S",
  "snippet": {
    "label": "Spam or misleading",
    "secondaryReasons": [
      {
        "id": "27",
        "label": "Spam or mass advertising"
      },
      {
        "id": "28",
        "label": "Misleading thumbnail"
      },
      {
        "id": "29",
        "label": "Malware or phishing"
      },
      {
        "id": "30",
        "label": "Pharmaceutical drugs for sale"
      },
      {
        "id": "31",
        "label": "Other misleading info"
      }
    ]
  }
}

    রিসোর্সে যেমন দেখানো হয়েছে, এই কারণটি সেকেন্ডারি কারণের তালিকার সাথে যুক্ত। স্প্যাম থাকার কারণে কোনও ভিডিও ফ্ল্যাগ করার সময়, আপনাকে কারণের আইডি দিতে হবে এবং তার সাথে দ্বিতীয় কারণও দেওয়ার জন্য আপনাকে বিশেষভাবে উৎসাহিত করা হচ্ছে।

  • ধাপ ২: আপত্তিজনক কন্টেন্টের জন্য ভিডিওটি ফ্ল্যাগ করুন

    ভিডিও সম্পর্কে অভিযোগ জানাতে videos.reportAbuse পদ্ধতিতে একটি অনুমোদিত অনুরোধ পাঠান। অনুরোধের বডি হল একটি JSON অবজেক্ট যা ফ্ল্যাগ করা ভিডিও এবং এটি ফ্ল্যাগ করার কারণ, দুটিই শনাক্ত করে। ধাপ ১-এ যেমন উল্লেখ করা হয়েছে, কিছু ধরনের কারণের জন্য, একটি সেকেন্ডারি কারণ কাজ করে এবং তা উল্লেখ করার জন্য বিশেষভাবে উৎসাহিত করা হয়।

    JSON অবজেক্টের videoId প্রপার্টি সেই ভিডিওকে শনাক্ত করে যেটিকে ফ্ল্যাগ করা হচ্ছে।

    নিচে দেওয়া JSON অবজেক্টের স্যাম্পেল, স্প্যাম বা বিভ্রান্তিকর কন্টেন্ট এবং আরও নির্দিষ্টভাবে, বিভ্রান্তিকর থাম্বনেল ছবি ব্যবহার করার জন্য একটি ভিডিও ফ্ল্যাগ করে। উপরে দেখানো স্যাম্পেল JSON অবজেক্ট অনুযায়ী, স্প্যাম বা বিভ্রান্তিকর কন্টেন্টের আইডি হল S। বিভ্রান্তিকর থাম্বনেলের আইডি হল ২৮।

    {
  "videoId": "VIDEO_ID",
  "reasonId": "S",
  "secondaryReasonId": "28",
  "comments": "Testing the video flagging feature.",
  "language": "en"
}

    videos.reportAbuse অনুরোধ OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। নিচের লিঙ্কটি APIs Explorer-এ উপরের JSON অবজেক্ট লোড করে। কোয়েরি পরীক্ষা করতে, আপনাকে videoId প্রপার্টি ভ্যালুর জন্য একটি সঠিক ভিডিও আইডি দিয়ে প্রতিস্থাপন করতে হবে। মনে রাখবেন, এই অনুরোধ জমা দিলে ভিডিওটি ফ্ল্যাগ করা হবে।

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.reportAbuse