এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

বাস্তবায়ন: ভিডিও

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

একটি চ্যানেলের আপলোড করা ভিডিওগুলি পুনরুদ্ধার করুন৷

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

ধাপ 1: চ্যানেলের আপলোড করা ভিডিওগুলির জন্য প্লেলিস্ট আইডি পুনরুদ্ধার করুন৷
চ্যানেলের আপলোড করা ভিডিও রয়েছে এমন প্লেলিস্টের আইডি পুনরুদ্ধার করতে channels.list পদ্ধতিতে কল করুন। অনুরোধের part প্যারামিটারের মানটিতে অবশ্যই contentDetails অন্তর্ভুক্ত করতে হবে কারণ channel রিসোর্স অংশগুলির একটি পুনরুদ্ধার করা হচ্ছে৷ API প্রতিক্রিয়াতে, contentDetails.relatedPlaylists.uploads প্রপার্টিতে প্লেলিস্ট আইডি থাকে।
চ্যানেল সনাক্ত করার বিভিন্ন উপায় আছে:
- বর্তমানে প্রমাণীকৃত ব্যবহারকারীর YouTube চ্যানেলের জন্য তথ্য পুনরুদ্ধার করতে mine প্যারামিটার মান true সেট করুন। আপনার অনুরোধ অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=contentDetails
        &mine=true
```
- ব্যবহারকারী নামের সাথে যুক্ত চ্যানেলের তথ্য পুনরুদ্ধার করতে একটি YouTube ব্যবহারকারীর নামের জন্য forUsername প্যারামিটার সেট করুন। এই উদাহরণটি Google-এর অফিসিয়াল YouTube চ্যানেলের তথ্য পুনরুদ্ধার করতে Google এর জন্য forUsername প্যারামিটার মান সেট করে।
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=contentDetails
        &forUsername=Google
```
- id প্যারামিটারটিকে YouTube চ্যানেল আইডিতে সেট করুন যা অনন্যভাবে সেই চ্যানেলটিকে সনাক্ত করে যার জন্য আপনি তথ্য পুনরুদ্ধার করছেন। এই উদাহরণটি id প্যারামিটারটিকে UCK8sQmJBp8GCxrOtXWBpyEA তে সেট করে, যা Google-এর অফিসিয়াল YouTube চ্যানেলকেও শনাক্ত করে৷
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=contentDetails
        &id=UCK8sQmJBp8GCxrOtXWBpyEA
```
ধাপ 2: আপলোড করা ভিডিওগুলির তালিকা পুনরুদ্ধার করুন
আপলোড করা ভিডিওগুলির তালিকা পুনরুদ্ধার করতে playlistItems.list পদ্ধতিতে কল করুন৷ playlistId প্যারামিটারের মানটি ধাপ 1 এ প্রাপ্ত মানের সাথে সেট করুন। এই উদাহরণে, প্যারামিটার মানটি 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 আলফা-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

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

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

API-এর videos.insert পদ্ধতির ডকুমেন্টেশনে বেশ কয়েকটি কোড নমুনা রয়েছে যা ব্যাখ্যা করে যে কীভাবে বিভিন্ন প্রোগ্রামিং ভাষা ব্যবহার করে একটি ভিডিও আপলোড করতে হয়।
পুনঃসূচনাযোগ্য আপলোড নির্দেশিকা HTTP অনুরোধের ক্রম ব্যাখ্যা করে যা একটি অ্যাপ্লিকেশন পুনরায় শুরুযোগ্য আপলোড প্রক্রিয়া ব্যবহার করে ভিডিও আপলোড করতে ব্যবহার করে। গাইডটি মূলত ডেভেলপারদের জন্য যারা Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারে না, যার মধ্যে কিছু আবার শুরু করা যায় এমন আপলোডের জন্য স্থানীয় সমর্থন প্রদান করে।
একটি ভিডিও আপলোড করার জন্য জাভাস্ক্রিপ্ট উদাহরণ CORS (ক্রস-অরিজিন রিসোর্স শেয়ারিং) ব্যবহার করে প্রদর্শন করে কিভাবে একটি ওয়েব পৃষ্ঠার মাধ্যমে একটি ভিডিও ফাইল আপলোড করতে হয়। CORS আপলোড লাইব্রেরি যেটি v3 API ব্যবহার করে স্বাভাবিকভাবেই পুনরায় শুরুযোগ্য আপলোডিং সমর্থন করে। উপরন্তু, উদাহরণটি দেখায় কিভাবে video রিসোর্সের processingDetails অংশ পুনরুদ্ধার করে আপলোড করা ভিডিওর স্ট্যাটাস চেক করা যায় এবং সেইসাথে আপলোড করা ভিডিওর স্ট্যাটাস পরিবর্তনগুলি কীভাবে পরিচালনা করা যায়।

আপলোড করা ভিডিওর স্থিতি পরীক্ষা করুন

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

ধাপ 1: ভিডিও আপলোড করুন
ভিডিও আপলোড করতে videos.insert পদ্ধতিতে কল করুন। অনুরোধ সফল হলে, API প্রতিক্রিয়াতে একটি video সংস্থান থাকবে যা আপলোড করা ভিডিওর জন্য অনন্য ভিডিও আইডি সনাক্ত করে৷
ধাপ 2: ভিডিওর স্থিতি পরীক্ষা করুন
ভিডিওর স্থিতি পরীক্ষা করতে videos.list পদ্ধতিতে কল করুন। id প্যারামিটারের মানটি ধাপ 1 এ প্রাপ্ত ভিডিও আইডিতে সেট করুন। part প্যারামিটারের মানটি processingDetails বিবরণে সেট করুন।
অনুরোধটি সফলভাবে পরিচালনা করা হলে, API প্রতিক্রিয়াতে একটি video সংস্থান থাকবে। YouTube এখনও ভিডিও প্রক্রিয়া করছে কিনা তা নির্ধারণ করতে processingDetails.processingStatus সম্পত্তির মান পরীক্ষা করুন৷ প্রপার্টির মান processing ব্যতীত অন্য কিছুতে পরিবর্তিত হবে, যেমন succeeded বা failed , যখন YouTube ভিডিওটি প্রক্রিয়াকরণ শেষ করে।
রিকোয়েস্ট বডি হল একটি video রিসোর্স যেখানে id প্রপার্টি আপনি যে ভিডিওটি মুছে দিচ্ছেন সেটির ভিডিও আইডি নির্দিষ্ট করে। এই উদাহরণে, সংস্থানটিতে একটি recordingDetails বস্তুও রয়েছে।
নীচের অনুরোধটি একটি ভিডিওর স্থিতি পরীক্ষা করে। APIs এক্সপ্লোরারে অনুরোধটি সম্পূর্ণ করতে, আপনাকে id সম্পত্তির মান সেট করতে হবে।
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
        part=snippet,processingDetails
        &id=VIDEO_ID
```

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

একটি ভিডিও আপডেট করুন

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

ধাপ 1: ভিডিও আইডি পুনরুদ্ধার করুন
বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেলের জন্য আপলোড করা ভিডিওগুলি পুনরুদ্ধার করতে উপরের পদক্ষেপগুলি অনুসরণ করুন৷ তালিকাটি ভিডিওগুলির একটি তালিকা প্রদর্শন করতে ব্যবহার করা যেতে পারে, প্রতিটি ভিডিওর আইডি একটি কী হিসাবে ব্যবহার করে৷
দ্রষ্টব্য: ভিডিও আইডি পাওয়ার অন্যান্য অনেক উপায় আছে, যেমন অনুসন্ধানের ফলাফল পুনরুদ্ধার করা বা প্লেলিস্টে আইটেম তালিকাভুক্ত করা। যাইহোক, যেহেতু একটি ভিডিও শুধুমাত্র তার মালিক দ্বারা আপডেট করা যেতে পারে, তাই ব্যবহারকারীর মালিকানাধীন ভিডিওগুলির একটি তালিকা পুনরুদ্ধার করা যা API অনুরোধ অনুমোদন করে এই প্রক্রিয়ার একটি সম্ভাব্য প্রথম পদক্ষেপ৷
ধাপ 2: একটি ভিডিও আপডেট করুন
একটি নির্দিষ্ট ভিডিও আপডেট করতে videos.update পদ্ধতিতে কল করুন। part প্যারামিটারের মান recordingDetails বিবরণে সেট করুন। (প্যারামিটার মান নির্ভর করে কোন ভিডিওর মেটাডেটা ক্ষেত্র আপডেট করা হচ্ছে তার উপর।)
রিকোয়েস্ট বডি হল একটি video রিসোর্স যেখানে id প্রোপার্টি আপনি যে ভিডিওটি আপডেট করছেন তার ভিডিও আইডি নির্দিষ্ট করে। এই উদাহরণে, সংস্থানটিতে একটি recordingDetails বস্তুও রয়েছে।
নীচের নমুনা সংস্থানটি নির্দেশ করে যে ভিডিওটি 30 অক্টোবর, 2013 তারিখে বোস্টনে রেকর্ড করা হয়েছিল:
```
{
  "id": "VIDEO_ID",
  "recordingDetails": {
    "location": {
      "latitude": "42.3464",
      "longitude": "-71.0975"
    }
    "recordingDate": "2013-10-30T23:15:00.000Z"
  }
}
```
APIs এক্সপ্লোরারে অনুরোধটি সম্পূর্ণ করতে, আপনাকে id সম্পত্তির মান সেট করতে হবে।
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=snippet
```

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

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

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

সম্পর্কিত কোড নমুনা: পিএইচপি , পাইথন

একটি ভিডিও মুছুন

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

ধাপ 1: ভিডিও আইডি পুনরুদ্ধার করুন
বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেলের জন্য আপলোড করা ভিডিওগুলি পুনরুদ্ধার করতে উপরের পদক্ষেপগুলি অনুসরণ করুন৷ তালিকাটি ভিডিওগুলির একটি তালিকা প্রদর্শন করতে ব্যবহার করা যেতে পারে, প্রতিটি ভিডিওর আইডি একটি কী হিসাবে ব্যবহার করে৷
দ্রষ্টব্য: ভিডিও আইডি পাওয়ার অন্যান্য অনেক উপায় আছে, যেমন অনুসন্ধানের ফলাফল পুনরুদ্ধার করা বা প্লেলিস্টে আইটেম তালিকাভুক্ত করা। যাইহোক, যেহেতু একটি ভিডিও শুধুমাত্র তার মালিকের দ্বারা মুছে ফেলা যায়, তাই API অনুরোধ অনুমোদনকারী ব্যবহারকারীর মালিকানাধীন ভিডিওগুলির একটি তালিকা পুনরুদ্ধার করা এই প্রক্রিয়ার একটি সম্ভাব্য প্রথম ধাপ।
ধাপ 2: একটি ভিডিও মুছুন
একটি নির্দিষ্ট ভিডিও মুছে ফেলার জন্য videos.delete পদ্ধতিতে কল করুন। অনুরোধে, id প্যারামিটারটি আপনি যে ভিডিওটি মুছে ফেলছেন তার ভিডিও আইডি নির্দিষ্ট করে। অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। আপনি যদি APIs এক্সপ্লোরারে এই ক্যোয়ারীটি পরীক্ষা করছেন, তাহলে আপনাকে id প্যারামিটার মানের জন্য একটি বৈধ ভিডিও আইডি প্রতিস্থাপন করতে হবে।
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.delete?
        id=VIDEO_ID
```

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

ধাপ 1: আইডিগুলি পুনরুদ্ধার করুন যা ব্যাখ্যা করে কেন ভিডিওটি রিপোর্ট করা হচ্ছে৷
একটি ভিডিও পতাকাঙ্কিত করার বৈধ কারণগুলির একটি তালিকা পুনরুদ্ধার করতে 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"
      }
    ]
  }
}
```
সম্পদ হিসাবে দেখানো হয়েছে, এই কারণটি গৌণ কারণগুলির একটি তালিকার সাথে যুক্ত। স্প্যাম থাকার জন্য একটি ভিডিও পতাকাঙ্কিত করার সময়, আপনাকে কারণটির জন্য আইডি প্রদান করতে হবে এবং একটি গৌণ কারণও প্রদান করতে দৃঢ়ভাবে উত্সাহিত করা হয়৷
ধাপ 2: অপমানজনক বিষয়বস্তুর জন্য ভিডিওটিকে ফ্ল্যাগ করুন
ভিডিওটি আসলে রিপোর্ট করার জন্য videos.reportAbuse পদ্ধতিতে একটি অনুমোদিত অনুরোধ পাঠান। অনুরোধের মূল অংশটি একটি JSON অবজেক্ট যা পতাকাঙ্কিত হওয়া ভিডিও এবং এটির পতাকাঙ্কিত হওয়ার কারণ উভয়ই সনাক্ত করে৷ ধাপ 1 এ উল্লিখিত হিসাবে, কিছু ধরণের কারণে, একটি গৌণ কারণ সমর্থিত এবং জোরালোভাবে উত্সাহিত করা হয়।
JSON অবজেক্টের videoId প্রপার্টি সেই ভিডিওটিকে চিহ্নিত করে যা পতাকাঙ্কিত করা হচ্ছে।
নীচের নমুনা JSON অবজেক্টটি স্প্যাম বা বিভ্রান্তিকর বিষয়বস্তু এবং আরও নির্দিষ্টভাবে, একটি বিভ্রান্তিকর থাম্বনেইল চিত্র ব্যবহার করার জন্য একটি ভিডিওকে ফ্ল্যাগ করে৷ উপরের নমুনা JSON অবজেক্টে দেখানো হয়েছে, স্প্যাম বা বিভ্রান্তিকর বিষয়বস্তুর আইডি হল S. একটি বিভ্রান্তিকর থাম্বনেইলের জন্য আইডি হল 28 ।
```
{
  "videoId": "VIDEO_ID",
  "reasonId": "S",
  "secondaryReasonId": "28",
  "comments": "Testing the video flagging feature.",
  "language": "en"
}
```
videos.reportAbuse অনুরোধটি OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। নীচের লিঙ্কটি APIs এক্সপ্লোরারে উপরের JSON অবজেক্টটিকে লোড করে। ক্যোয়ারী পরীক্ষা করার জন্য, videoId প্রপার্টি মানের জন্য আপনাকে একটি বৈধ ভিডিও আইডি প্রতিস্থাপন করতে হবে। অনুগ্রহ করে মনে রাখবেন যে এই অনুরোধটি জমা দেওয়া আসলে ভিডিওটিকে পতাকাঙ্কিত করবে৷
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.reportAbuse
```