Members

member রিসোর্স YouTube চ্যানেলের মেম্বারকে উপস্থাপিত করে। একজন মেম্বার ক্রিয়েটরকে নিয়মিত আর্থিক সহায়তা প্রদান করেন এবং বিশেষ সুবিধা পান। যেমন, ক্রিয়েটর কোনও চ্যাটের জন্য শুধুমাত্র মেম্বারদের জন্য মোড চালু করলে, মেম্বাররা চ্যাট করতে পারবেন।

নিম্নলিখিত অ্যাক্সেস সংক্রান্ত বিধিনিষেধ প্রযোজ্য:

• members এবং membershipsLevels এন্ডপয়েন্টে অ্যাক্সেস করার সুবিধা YouTube ক্রিয়েটরদের জন্য সীমিত করা হয়েছে যাদের একজন ডেডিকেটেড YouTube পার্টনার ম্যানেজার রয়েছেন।
• চ্যানেল লেভেলে অ্যাক্সেস মঞ্জুর করা হয়। এই চ্যানেল-লেভেল শ্বেততালিকার কারণে, youtube.channel-memberships.creator OAuth স্কোপ স্ট্যান্ডার্ড Google Cloud OAuth যাচাইকরণ প্রসেসের মধ্য দিয়ে যায় না।

পদ্ধতি

API, member রিসোর্সের জন্য নিম্নলিখিত পদ্ধতিগুলি সমর্থন করে:

তালিকা

কোনও চ্যানেলের জন্য তালিকাভুক্ত মেম্বার (আগে "স্পনসর" হিসেবে পরিচিত)। চ্যানেলের মালিককে API অনুরোধ অনুমোদন করতে হবে।

রিসোর্স রিপ্রেজেন্টেশন

নিম্নলিখিত JSON স্ট্রাকচার member রিসোর্সের ফর্ম্যাট দেখায়:

{
  "kind": "youtube#member",
  "etag": etag,
  "snippet": {
    "creatorChannelId": string,
    "memberDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "membershipsDetails": {
      "highestAccessibleLevel": string,
      "highestAccessibleLevelDisplayName": string,
      "accessibleLevels": [
        string
      ],
      "membershipsDuration": {
        "memberSince": datetime,
        "memberTotalDurationMonths": integer,
      },
      "membershipsDurationAtLevel": [
        {
          "level": string,
          "memberSince": datetime,
          "memberTotalDurationMonths": integer,
        }
      ]
    }
  }
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#member।
etag	etag এই রিসোর্সের Etag.
snippet	object snippet অবজেক্টে মেম্বার সম্পর্কে বিবরণ থাকে।
snippet.creatorChannelId	string যে ক্রিয়েটর মেম্বারশিপ অফার করেন তার YouTube চ্যানেল আইডি।
snippet.memberDetails	object এই অবজেক্টে YouTube চ্যানেলের প্রোফাইল ডেটা থাকে যা মেম্বারশিপের জন্য পেমেন্ট করছে। মনে রাখবেন, কোনও চ্যানেলে এমন মেম্বার থাকতে পারেন যাদের প্রোফাইল ডেটা উপলভ্য নেই। যেমন, যেসব মেম্বার তাদের চ্যানেল মুছে দিয়েছেন কিন্তু এখনও মেম্বারশিপের জন্য পেমেন্ট করছেন তাদের ক্ষেত্রে এটি ঘটে। মনে রাখবেন যে এইসব মেম্বার এখনও তাদের মেম্বারশিপের সুবিধা অ্যাক্সেস করতে পারবেন। API রেসপন্সে সেইসব মেম্বারের রিসোর্স অন্তর্ভুক্ত থাকে যাতে memberDetails অবজেক্টের মধ্যে প্রোফাইল বিবরণ সেট করা না থাকলেও সঠিক গণনা নিশ্চিত করা যায়। এইসব মেম্বারদের membershipsDetails এখনও প্রদান করা হয়।
snippet.memberDetails.channelId	string মেম্বার চ্যানেলের YouTube চ্যানেল আইডি। এটি সেট করা থাকলে, চ্যানেল আইডিকেও মেম্বারের অনন্য শনাক্তকারী হিসেবে বিবেচনা করা যেতে পারে। এটি সেট করা না থাকলে, মেম্বারকে অনন্যভাবে শনাক্ত করা যাবে না, তবে রিসোর্সটি এখনও মেম্বারশিপের বিবরণ জানায়, যেমন মেম্বার যে লেভেল অ্যাক্সেস করতে পারেন এবং তার মেম্বারশিপের মেয়াদ।
snippet.memberDetails.channelUrl	string চ্যানেলের URL.
snippet.memberDetails.displayName	string চ্যানেলের ডিসপ্লে নাম।
snippet.memberDetails.profileImageUrl	string চ্যানেলের অবতার URL।
snippet.membershipsDetails	object এই অবজেক্টে মেম্বার চ্যানেলের মেম্বারশিপ সংক্রান্ত বিবরণ থাকে।
snippet.membershipsDetails.highestAccessibleLevel	string মেম্বার চ্যানেল বর্তমানে অ্যাক্সেস করতে পারে এমন সর্বোচ্চ মেম্বারশিপ লেভেলের আইডি। ভ্যালুটি membershipsLevel রিসোর্সে id প্রপার্টি ভ্যালুর সাথে সম্পর্কিত।
snippet.membershipsDetails.highestAccessibleLevelDisplayName	string মেম্বার চ্যানেল বর্তমানে অ্যাক্সেস করতে পারে এমন সর্বোচ্চ মেম্বারশিপ লেভেলের নাম। এই ভ্যালু membershipsLevel রিসোর্সে displayName প্রপার্টি ভ্যালুর সাথে সম্পর্কিত।
snippet.membershipsDetails.accessibleLevels[]	list (of strings) ব্যবহারকারী বর্তমানে অ্যাক্সেস করতে পারবেন এমন সব মেম্বারশিপ লেভেলের আইডির তালিকা। তালিকায় বর্তমানে অ্যাক্টিভ লেভেল এবং তার নিচের সব লেভেল অন্তর্ভুক্ত থাকে।
snippet.membershipsDuration	object এই অবজেক্টে বর্তমান মেম্বারের মেম্বারশিপের সামগ্রিক সময়সীমা সংক্রান্ত তথ্য থাকে। এতে দামের লেভেল বিবেচনা করা হয় না। তারপর, snippet.membershipsDetails.membershipsDurationAtLevel[] প্রপার্টিতে অবজেক্টের একটি তালিকা থাকে, যেখানে মেম্বারশিপের একটি নির্দিষ্ট সময়কাল সম্পর্কে বিবরণ থাকে যে সময়কালে মেম্বারের কাছে একটি নির্দিষ্ট মেম্বারশিপ লেভেলে অ্যাক্সেস ছিল। নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে এইসব প্রপার্টি কাজ করে: কোনও মেম্বার জানুয়ারিতে মেম্বারশিপ লেভেল ১-এ নতুন মেম্বারশিপ নেন এবং মার্চ পর্যন্ত সেই মেম্বারশিপ থাকে। এপ্রিল ও মে মাসে, মেম্বারের কাছে মেম্বারশিপ নেই। জুন মাসে, মেম্বার আবার লেভেল ১-এ মেম্বারশিপ চালু করেন। তারপর, আগস্ট মাসে, মেম্বার তার মেম্বারশিপ লেভেল ২-এ আপগ্রেড করেন। তাই, অক্টোবরে কোনও API কল করা হলে, member রিসোর্সে নিম্নলিখিত তথ্য থাকবে: "membershipsDetails": { "membershipsDuration": { "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7, }, "membershipsDurationAtLevel": [ { "level": "level_1_ID", "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7 }, { "level": "level_2_ID", "memberSince": "2020-08-01T12:00:00", "memberTotalDurationMonths": 2 }, ] }
snippet.membershipsDuration.memberSince	datetime মেম্বারের বর্তমান মেম্বারশিপ শুরু হওয়ার তারিখ ও সময়। অন্যভাবে বলতে গেলে, এই তারিখ ও সময় থেকে মেম্বার অবিচ্ছিন্নভাবে মেম্বারশিপে আছেন। মনে রাখবেন, মেম্বারশিপের বিভিন্ন সময়সীমা আলাদা আলাদা মেম্বারশিপ লেভেলে কাটানো হতে পারে।
snippet.membershipsDuration.memberTotalDurationMonths	integer ব্যবহারকারী যত মাস মেম্বার ছিলেন, সেই সংখ্যাকে নিকটতম পূর্ণসংখ্যায় রাউন্ড ডাউন করা হয়েছে। মেম্বারশিপের ভ্যালু হল মেম্বারশিপের সম্পূর্ণ মাসের সংখ্যা, কিন্তু এই সংখ্যাটি বোঝায় না যে মেম্বারটি সেই কয়েক মাস ধরে একটানা মেম্বারশিপ নিয়েছেন।
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[]	list (of objects) অবজেক্টের একটি তালিকা, যার প্রতিটি অবজেক্টে মেম্বারশিপের এমন একটি সময়সীমার বিবরণ থাকে যেখানে মেম্বারের কাছে নির্দিষ্ট মেম্বারশিপ লেভেলে অ্যাক্সেস ছিল। মেম্বার বর্তমানে অ্যাক্সেস করতে পারেন এমন প্রতিটি মেম্বারশিপ লেভেলের জন্য তালিকায় একটি করে অবজেক্ট থাকে।
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level	string মেম্বারশিপ লেভেল আইডি। এই ভ্যালু membershipsLevel রিসোর্সে id প্রপার্টি ভ্যালুর সাথে সম্পর্কিত।
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince	datetime যে তারিখ ও সময় থেকে মেম্বার নির্দিষ্ট মেম্বারশিপ লেভেলে অ্যাক্সেস পেয়েছেন। অন্য কথায়, এই তারিখ ও সময় থেকে মেম্বার একটানা লেভেল অ্যাক্সেস করেছেন। মনে রাখবেন, মেম্বারশিপের বিভিন্ন মেয়াদ উন্নত মেম্বারশিপ লেভেলে কাটানো হতে পারে।
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths	integer ব্যবহারকারী যত মাস ধরে নির্দিষ্ট লেভেলে অ্যাক্সেস পেয়েছেন, সেই সংখ্যাটি নিকটতম পূর্ণ সংখ্যায় রাউন্ড ডাউন করা হয়েছে। মেম্বার যত মাস ধরে লেভেল অ্যাক্সেস করেছেন, ভ্যালু থেকে তা বোঝা যায়। তবে, এর অর্থ এই নয় যে মেম্বার তত মাস ধরে একটানা মেম্বারশিপ নিয়েছেন।