বাস্তবায়ন: প্লেলিস্ট

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

বর্তমান ব্যবহারকারীর প্লেলিস্ট পুনরুদ্ধার করুন

বর্তমানে প্রমাণীকৃত ব্যবহারকারীর প্লেলিস্টগুলি পুনরুদ্ধার করতে playlists.list পদ্ধতিতে কল করুন৷ আপনার অনুরোধে, mine প্যারামিটারের মান true সেট করুন। মনে রাখবেন যে mine প্যারামিটার ব্যবহার করে এমন একটি অনুরোধ অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=snippet,contentDetails
        &mine=true

একজন ব্যবহারকারীর প্লেলিস্ট পুনরুদ্ধার করুন

এই উদাহরণটি একটি নির্দিষ্ট চ্যানেল দ্বারা তৈরি প্লেলিস্টগুলি পুনরুদ্ধার করে৷ উদাহরণের দুটি ধাপ রয়েছে:

একটি নির্দিষ্ট প্লেলিস্ট সম্পর্কে তথ্য পুনরুদ্ধার করুন

এক বা একাধিক নির্দিষ্ট প্লেলিস্ট সম্পর্কে তথ্য পুনরুদ্ধার করতে, playlists.list পদ্ধতিতে কল করুন এবং id প্যারামিটারটিকে YouTube প্লেলিস্ট আইডিগুলির একটি কমা-বিভক্ত তালিকাতে সেট করুন যা পছন্দসই সংস্থানগুলি সনাক্ত করে৷ এই কার্যকারিতার জন্য একটি সাধারণ ব্যবহারের ক্ষেত্রে অনুসন্ধান ফলাফলের একটি সেটে ফিরে আসা প্লেলিস্টের একটি গ্রুপ সম্পর্কে অতিরিক্ত তথ্য পুনরুদ্ধার করার একটি অনুরোধ। উদাহরণস্বরূপ, আপনি প্রতিটি প্লেলিস্টে আইটেমের সংখ্যা পুনরুদ্ধার করতে চাইতে পারেন।

নীচের অনুরোধটি "GoogleDevelopers" কোয়েরি শব্দের সাথে মেলে এমন দুটি প্লেলিস্টের আইটেমের সংখ্যা পুনরুদ্ধার করতে playlists.list পদ্ধতিকে কল করে৷ এই তথ্যটি playlist রিসোর্সের contentDetails.itemCount প্রপার্টিতে রয়েছে, তাই অনুরোধটি part প্যারামিটার মানকে contentDetails এ সেট করে।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=contentDetails
        &id=PLOU2XLYxmsIIM9h1Ybw2DuRw6o2fkNMeR,PLyYlLs02rgBYRWBzYpoHz7m2SE8mEZ68w

একটি প্লেলিস্ট যোগ করুন

এই উদাহরণটি প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে একটি ব্যক্তিগত প্লেলিস্ট তৈরি করতে playlists.insert পদ্ধতিকে কল করে। এই পদ্ধতিতে যেকোনো API অনুরোধ অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.insert?
        part=snippet,status

APIs এক্সপ্লোরারের লিঙ্কটি একটি পরামিতিও সেট করে যা API অনুরোধের মূল অংশটি নির্দিষ্ট করে। অনুরোধের অংশে একটি playlist সংস্থান রয়েছে, যা প্লেলিস্টের শিরোনাম, বিবরণ এবং গোপনীয়তার স্থিতির মতো তথ্য সংজ্ঞায়িত করে৷ এই উদাহরণে, অনুরোধের অংশ হল:

{
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "private"
  }
}

সম্পর্কিত কোড নমুনা: Java , JavaScript , .NET , PHP , Python

একটি প্লেলিস্ট আপডেট করুন

এই উদাহরণটি একটি প্লেলিস্টের গোপনীয়তার স্থিতি private থেকে public আপডেট করে৷ উদাহরণের দুটি ধাপ রয়েছে:

  • ধাপ 1: প্লেলিস্ট আইডি পুনরুদ্ধার করুন

    বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে প্লেলিস্টগুলি পুনরুদ্ধার করতে playlist.list পদ্ধতিতে কল করুন৷ বর্তমান ব্যবহারকারীর প্লেলিস্ট পুনরুদ্ধার করার জন্য উপরে নমুনা অনুরোধ এই অনুরোধ প্রদর্শন করে. API কল করা অ্যাপ্লিকেশনটি প্রতিটি প্লেলিস্টের আইডি একটি কী হিসাবে ব্যবহার করে প্লেলিস্টের একটি তালিকা প্রদর্শন করতে API প্রতিক্রিয়া প্রক্রিয়া করতে পারে।

  • ধাপ 2: একটি প্লেলিস্ট আপডেট করা হচ্ছে

    একটি নির্দিষ্ট প্লেলিস্ট পরিবর্তন করতে playlists.update পদ্ধতিতে কল করুন। এই পদ্ধতির জন্য একটি বৈধ OAuth 2.0 অনুমোদন টোকেন প্রয়োজন৷

    অনুরোধের মূল অংশে অবশ্যই playlist রিসোর্সের snippet অংশ অন্তর্ভুক্ত করতে হবে কারণ এই পদ্ধতিতে কল করার সময় snippet.title প্রপার্টির প্রয়োজন হয়। উপরন্তু, যদি প্লেলিস্ট রিসোর্স আপডেট করা হচ্ছে snippet.description বা snippet.tags বৈশিষ্ট্যের জন্য মান নির্দিষ্ট করে, সেই মানগুলি অবশ্যই আপডেট অনুরোধে নির্দিষ্ট করতে হবে বা সেগুলি মুছে ফেলা হবে।

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

    একটি প্লেলিস্ট যোগ করার জন্য উপরের উদাহরণের মতো, APIs এক্সপ্লোরারের লিঙ্কটি একটি প্যারামিটার সেট করে যা API অনুরোধের মূল অংশটি নির্দিষ্ট করে। অনুরোধের অংশে একটি playlist সংস্থান রয়েছে, যা প্লেলিস্টের শিরোনাম, বিবরণ এবং গোপনীয়তার স্থিতির মতো তথ্য সংজ্ঞায়িত করে৷ এই উদাহরণে নিম্নলিখিত অনুরোধের অংশটি ব্যবহার করা হয়েছে:

    {
      "id": "PLAYLIST_ID",
      "snippet": {
        "title": "New playlist",
        "description": "New playlist description"
      },
      "status": {
        "privacyStatus": "public"
      }
    }

    দ্রষ্টব্য: আপনি যদি APIs এক্সপ্লোরারে এই ক্যোয়ারীটি পরীক্ষা করছেন, তাহলে আপনাকে রিসোর্স বডিতে একটি বৈধ প্লেলিস্ট আইডি প্রতিস্থাপন করতে হবে। একটি প্লেলিস্ট আইডি পেতে, আমরা সুপারিশ করি যে আপনি প্রথমে একটি প্লেলিস্ট যোগ করার জন্য উপরে দেখানো অনুরোধটি চালান৷ API প্রতিক্রিয়া থেকে প্লেলিস্ট আইডি বের করুন এবং আপনি যে প্লেলিস্ট আপডেট করতে চান তার জন্য সেই মানটি ব্যবহার করুন। এই উদাহরণে ব্যবহৃত প্লেলিস্ট শিরোনাম এবং বিবরণ সেই উদাহরণে ব্যবহৃত একই।

একটি প্লেলিস্ট আইটেম যোগ করুন

এই উদাহরণটি একটি প্লেলিস্টে একটি আইটেম যোগ করে। এই অনুরোধটি OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। এই উদাহরণে দুটি ধাপ রয়েছে:

  • ধাপ 1: উপযুক্ত প্লেলিস্ট আইডি পুনরুদ্ধার করুন

    বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে প্লেলিস্টগুলি পুনরুদ্ধার করতে playlist.list পদ্ধতিতে কল করুন৷ বর্তমান ব্যবহারকারীর প্লেলিস্ট পুনরুদ্ধার করার জন্য উপরে নমুনা অনুরোধ এই অনুরোধ প্রদর্শন করে. API কল করা অ্যাপ্লিকেশনটি প্রতিটি প্লেলিস্টের আইডি একটি কী হিসাবে ব্যবহার করে প্লেলিস্টের একটি তালিকা প্রদর্শন করতে API প্রতিক্রিয়া প্রক্রিয়া করতে পারে।

  • ধাপ 2: প্লেলিস্টে একটি ভিডিও যোগ করুন

    প্লেলিস্টে একটি ভিডিও যোগ করতে playlistItems.insert পদ্ধতিতে কল করুন। এই অনুরোধটি OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। অনুরোধের মূল অংশটি হল একটি playlistItem সংস্থান যা কমপক্ষে নিম্নলিখিত মানগুলি নির্দিষ্ট করে:

    • snippet.playlistId সেই প্লেলিস্টটিকে চিহ্নিত করে যেখানে আপনি ভিডিওটি যোগ করছেন। এটি হল প্লেলিস্ট আইডি যা আপনি ধাপ 1 এ প্রাপ্ত করেছেন।
    • snippet.resourceId.kindyoutube#video মান রয়েছে।
    • snippet.resourceId.videoId সেই ভিডিওটিকে চিহ্নিত করে যা আপনি প্লেলিস্টে যোগ করছেন। সম্পত্তির মান একটি অনন্য YouTube ভিডিও আইডি।

    নীচের API অনুরোধটি একটি প্লেলিস্টে একটি ভিডিও যুক্ত করে৷ অনুরোধের বডি হল:

    {
      "snippet": {
        "playlistId": "PLAYLIST_ID",
        "resourceId": {
          "kind": "youtube#video",
          "videoId": "VIDEO_ID"
        }
      }
    }

    APIs এক্সপ্লোরারে অনুরোধটি সম্পূর্ণ করতে, আপনাকে snippet.playlistId এবং snippet.resourceId.videoId বৈশিষ্ট্যগুলির জন্য মান সেট করতে হবে৷

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

    দ্রষ্টব্য: playlistItems.insert পদ্ধতির জন্য ডকুমেন্টেশন অন্যান্য সম্পত্তি মান চিহ্নিত করে যা আপনি একটি প্লেলিস্ট আইটেম যোগ করার সময় সেট করতে পারেন।

একটি প্লেলিস্ট আইটেম আপডেট করুন

এই উদাহরণটি একটি প্লেলিস্ট আইটেম আপডেট করে যাতে এটি একটি প্লেলিস্টের প্রথম আইটেম। এই অনুরোধটি OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। এই উদাহরণে তিনটি ধাপ রয়েছে:

  • ধাপ 1: উপযুক্ত প্লেলিস্ট আইডি পুনরুদ্ধার করুন

    বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে প্লেলিস্টগুলি পুনরুদ্ধার করতে playlist.list পদ্ধতিতে কল করুন৷ বর্তমান ব্যবহারকারীর প্লেলিস্ট পুনরুদ্ধার করার জন্য উপরে নমুনা অনুরোধ এই অনুরোধ প্রদর্শন করে. API কল করা অ্যাপ্লিকেশনটি প্রতিটি প্লেলিস্টের আইডি একটি কী হিসাবে ব্যবহার করে প্লেলিস্টের একটি তালিকা প্রদর্শন করতে API প্রতিক্রিয়া প্রক্রিয়া করতে পারে।

  • ধাপ 2: নির্বাচিত প্লেলিস্টের আইটেমগুলি পুনরুদ্ধার করুন

    নির্বাচিত প্লেলিস্টের ভিডিওগুলির তালিকা পুনরুদ্ধার করতে playlistItems.list পদ্ধতিতে কল করুন। playlistId আইডি প্যারামিটারের মানটি প্লেলিস্ট আইডিতে সেট করুন যা আপনি ধাপ 1 এ পেয়েছেন।

    API প্রতিক্রিয়ার প্রতিটি সংস্থানে একটি id বৈশিষ্ট্য রয়েছে, যা প্লেলিস্ট আইটেম আইডি সনাক্ত করে যা সেই আইটেমটিকে অনন্যভাবে সনাক্ত করে। পরবর্তী ধাপে তালিকা থেকে একটি আইটেম সরাতে আপনি সেই মানটি ব্যবহার করবেন।

  • ধাপ 3: নির্বাচিত প্লেলিস্ট আইটেম আপডেট করুন

    প্লেলিস্টে ভিডিওর অবস্থান পরিবর্তন করতে playlistItems.update পদ্ধতিতে কল করুন। part প্যারামিটার মান snippet সেট করুন। অনুরোধের মূল অংশটি অবশ্যই একটি playlistItem সংস্থান হতে হবে যা কমপক্ষে নিম্নলিখিত মানগুলি সেট করে:

    • ধাপ 2 এ প্রাপ্ত প্লেলিস্ট আইটেম আইডিতে id সম্পত্তি সেট করুন।
    • ধাপ 1 এ প্রাপ্ত প্লেলিস্ট আইডিতে snippet.playlistId প্রপার্টি সেট করুন।
    • youtube#videosnippet.resourceId.kind প্রপার্টি সেট করুন।
    • ভিডিও আইডিতে snippet.resourceId.videoId প্রপার্টি সেট করুন যা প্লেলিস্টে অন্তর্ভুক্ত ভিডিওটিকে অনন্যভাবে সনাক্ত করে।
    • snippet.position প্রপার্টি 0 তে সেট করুন বা আপনি আইটেমটি যে কোন অবস্থানে দেখতে চান (0-ভিত্তিক সূচক ব্যবহার করে)।

    নীচের API অনুরোধটি একটি প্লেলিস্ট আইটেমটিকে প্লেলিস্টের প্রথম আইটেম হতে আপডেট করে৷ অনুরোধের বডি হল:

    {
      "id": "PLAYLIST_ITEM_ID",
      "snippet": {
        "playlistId": "PLAYLIST_ID",
        "resourceId": {
          "kind": "youtube#video",
          "videoId": "VIDEO_ID"
        },
        "position": 0
      }
    }

    APIs এক্সপ্লোরারে অনুরোধটি সম্পূর্ণ করতে, আপনাকে id , snippet.playlistId এবং snippet.resourceId.videoId বৈশিষ্ট্যগুলির জন্য মান সেট করতে হবে৷

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

একটি প্লেলিস্ট আইটেম সরান

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

এই পদক্ষেপগুলি সম্পূর্ণ করার পরে, প্লেলিস্ট থেকে একটি ভিডিও সরাতে playlistItems.delete পদ্ধতিতে কল করুন৷ আপনি যে আইটেমটি সরাতে চান তার জন্য প্লেলিস্ট আইটেম আইডিতে অনুরোধের id প্যারামিটার সেট করুন। এই অনুরোধটি OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

মনে রাখবেন যে প্লেলিস্ট আইটেম আইডি একটি প্লেলিস্টে একটি ভিডিও সনাক্ত করতে ব্যবহৃত YouTube ভিডিও আইডি থেকে আলাদা যা ভিডিওটিকে অনন্যভাবে সনাক্ত করে৷ প্লেলিস্ট আইটেম আইডি ভিডিওটিকে একটি নির্দিষ্ট প্লেলিস্টের একটি আইটেম হিসাবে চিহ্নিত করে৷

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

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

একটি প্লেলিস্ট সরান

এই উদাহরণটি একটি প্লেলিস্ট মুছে দেয়। উদাহরণের দুটি ধাপ রয়েছে:

  • ধাপ 1: প্লেলিস্ট আইডি পুনরুদ্ধার করুন

    বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে প্লেলিস্টগুলি পুনরুদ্ধার করতে playlist.list পদ্ধতিতে কল করুন৷ বর্তমান ব্যবহারকারীর প্লেলিস্ট পুনরুদ্ধার করার জন্য উপরে নমুনা অনুরোধ এই অনুরোধ প্রদর্শন করে. API কল করা অ্যাপ্লিকেশনটি প্রতিটি প্লেলিস্টের আইডি একটি কী হিসাবে ব্যবহার করে প্লেলিস্টের একটি তালিকা প্রদর্শন করতে API প্রতিক্রিয়া প্রক্রিয়া করতে পারে।

  • ধাপ 2: একটি প্লেলিস্ট মুছে ফেলা হচ্ছে

    একটি নির্দিষ্ট প্লেলিস্ট মুছে ফেলার জন্য playlists.delete পদ্ধতিতে কল করুন। অনুরোধে, id প্যারামিটারটি মুছে ফেলা প্লেলিস্টের প্লেলিস্ট আইডি নির্দিষ্ট করে। এই পদ্ধতির জন্য একটি বৈধ OAuth 2.0 অনুমোদন টোকেন প্রয়োজন৷ আপনি যদি APIs এক্সপ্লোরারে এই ক্যোয়ারীটি পরীক্ষা করে থাকেন, তাহলে আপনাকে একটি বৈধ প্লেলিস্ট আইডি দিয়ে id প্যারামিটার মান প্রতিস্থাপন করতে হবে।

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

    দ্রষ্টব্য: আপনি যদি APIs এক্সপ্লোরারে এই ক্যোয়ারীটি পরীক্ষা করছেন, তাহলে আপনাকে একটি বৈধ প্লেলিস্ট আইডি দিয়ে id প্যারামিটার মান প্রতিস্থাপন করতে হবে। একটি প্লেলিস্ট আইডি পেতে, আমরা সুপারিশ করি যে আপনি প্রথমে একটি প্লেলিস্ট যোগ করার জন্য উপরে দেখানো অনুরোধটি চালান৷ API প্রতিক্রিয়া থেকে প্লেলিস্ট আইডি বের করুন এবং আপনি যে প্লেলিস্টটি মুছতে চান তার জন্য সেই মানটি ব্যবহার করুন।