Members

দ্রষ্টব্য: 31 মার্চ, 2020 থেকে, members এন্ডপয়েন্ট sponsors এন্ডপয়েন্টকে প্রতিস্থাপন করে, যেটি এখন অবমূল্যায়িত হয়েছে এবং 30 সেপ্টেম্বর, 2020 এর পরে আর সমর্থিত হবে না। এপিআই ক্লায়েন্টদের members.list ব্যবহার করার জন্য sponsors.list পদ্ধতিতে কল আপডেট করা উচিত। পরিবর্তে members.list পদ্ধতি.

এই এন্ডপয়েন্টটি শুধুমাত্র স্বতন্ত্র নির্মাতারা তাদের নিজস্ব, চ্যানেল-মেম্বারশিপ-সক্ষম YouTube চ্যানেলের জন্য অনুরোধ করতে ব্যবহার করতে পারেন। অ্যাক্সেসের অনুরোধ করতে আপনার Google বা YouTube প্রতিনিধির সাথে যোগাযোগ করুন।

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

পদ্ধতি

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

list
একটি চ্যানেলের জন্য সদস্যদের (পূর্বে "স্পন্সর" নামে পরিচিত) তালিকা করে। 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[] প্রপার্টিতে তারপর অবজেক্টের একটি তালিকা থাকে যা সদস্যতার সময়কাল সম্পর্কে বিশদ বিবরণ ধারণ করে যে সময়ে সদস্যের একটি নির্দিষ্ট সদস্যপদ স্তরে অ্যাক্সেস ছিল।

নিম্নলিখিত উদাহরণ দেখায় যে এই বৈশিষ্ট্যগুলি কীভাবে কাজ করে: একজন সদস্য জানুয়ারিতে সদস্যপদ স্তর 1-এ একটি নতুন সদস্যপদ ক্রয় করেন এবং সেই সদস্যতা মার্চ পর্যন্ত থাকে। এপ্রিল ও মে মাসে সদস্যপদ থাকে না। জুন মাসে, সদস্য তাদের সদস্যতা পুনরায় শুরু করে, আবার লেভেল 1 এ। তারপর, আগস্টে, সদস্য তাদের সদস্যতা লেভেল 2 এ আপগ্রেড করে। সুতরাং, যদি অক্টোবরে একটি 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
মাসের সংখ্যা, নিকটতম পূর্ণসংখ্যায় বৃত্তাকার, ব্যবহারকারীর নির্দিষ্ট স্তরে অ্যাক্সেস আছে। মানটি প্রতিফলিত করে যে সদস্যের স্তরে অ্যাক্সেস রয়েছে এমন সম্পূর্ণ মাসগুলির সংখ্যা, তবে সংখ্যাটি বোঝায় না যে সদস্যটি সেই বহু মাস ধরে অবিচ্ছিন্ন সদস্যপদ রয়েছে৷