দ্রষ্টব্য: YouTube বিকাশকারী নীতিগুলি মেনে চলা আপনাকে সহায়তা করার জন্য নির্দেশিকা এবং উদাহরণ প্রদান করে যে আপনার API ক্লায়েন্টরা YouTube API পরিষেবার শর্তাবলী এবং নীতিগুলির (API TOS) নির্দিষ্ট অংশগুলি অনুসরণ করে। গাইডটি কীভাবে YouTube এপিআই TOS-এর নির্দিষ্ট দিকগুলিকে প্রয়োগ করে তার অন্তর্দৃষ্টি প্রদান করে, কিন্তু এটি বিদ্যমান কোনো নথি প্রতিস্থাপন করে না।
এই দস্তাবেজটি API ক্লায়েন্টদের জন্য ন্যূনতম কার্যকরী প্রয়োজনীয়তাগুলিকে সংজ্ঞায়িত করে যা YouTube API পরিষেবাগুলির ("API ক্লায়েন্ট") নির্দিষ্ট বৈশিষ্ট্যগুলি বাস্তবায়ন বা অ্যাক্সেস প্রদান করে৷
এই প্রয়োজনীয়তা এবং নির্দেশিকাগুলি নিশ্চিত করে যে API ক্লায়েন্টরা একটি ধারাবাহিক ব্যবহারকারীর অভিজ্ঞতা প্রদান করে যা YouTube ব্যবহারকারী, বিষয়বস্তুর মালিক এবং বিজ্ঞাপনদাতাদের স্বার্থ রক্ষা করে। এই নিয়মগুলি YouTube API পরিষেবার শর্তাবলীর একটি অবিচ্ছেদ্য অংশ এবং যেকোন API ক্লায়েন্টের বিকাশ ও বাস্তবায়নে অবশ্যই অনুসরণ করা উচিত৷
আপনি এই নথির প্রয়োজনীয়তাগুলি পরিবর্তন করার আশা করা উচিত যাতে আমরা বিদ্যমান YouTube বৈশিষ্ট্যগুলির সাথে আরও ভাল ব্যবহারকারীর অভিজ্ঞতা নিশ্চিত করতে পারি৷ নতুন এবং আপডেট হওয়া YouTube বৈশিষ্ট্যগুলির প্রতিক্রিয়াতেও তারা পরিবর্তন হবে৷ কখনও কখনও, এই ধরনের পরিবর্তনগুলি আপনাকে আপনার API ক্লায়েন্টগুলিকে নতুন প্রয়োজনীয়তাগুলি সমাধান করতে আপডেট করতে হতে পারে৷ পরিষেবার শর্তাদি পুনর্বিবেচনার ইতিহাস যে কোনও পরিবর্তনের নথিভুক্ত করবে, তাই অনুগ্রহ করে ঘন ঘন সেই নথিটি পরীক্ষা করুন, বা এর RSS ফিডে সদস্যতা নিন, নিশ্চিত করুন যে আপনি আপনার API ক্লায়েন্টদের প্রভাবিত করতে পারে এমন পরিবর্তনগুলি সম্পর্কে দ্রুত জানতে পারেন৷
এই ডকুমেন্টের প্রয়োজনীয়তাগুলি ছাড়াও, আমরা আপনাকে YouTube API পরিষেবা নীতিগুলিতে বর্ণিত সর্বোত্তম অনুশীলনগুলি অনুসরণ করার এবং YouTube API পরিষেবাগুলির ডকুমেন্টেশনে অন্যত্র আলোচনা করার সুপারিশ করছি৷ এমনকি কঠোরভাবে প্রয়োজন না হলেও, এই অনুশীলনগুলি আপনার API ক্লায়েন্টদের ত্রুটি থেকে আরও দ্রুত পুনরুদ্ধার করতে এবং তাদের কোটা ব্যবহার অপ্টিমাইজ করতে সাহায্য করে যদি তারা কোটা বরাদ্দকারী YouTube API পরিষেবাগুলি ব্যবহার করে। একই সময়ে, এই অনুশীলনগুলি YouTube ইকোসিস্টেমের স্বাস্থ্য নিশ্চিত করতে এবং সর্বোপরি, আপনার API ক্লায়েন্ট এবং YouTube অ্যাপ্লিকেশনগুলির ব্যবহারকারীদের সম্ভাব্য সর্বোত্তম অভিজ্ঞতা প্রদান করতে সহায়তা করে৷
YouTube এম্বেড করা প্লেয়ার এবং ভিডিও প্লেব্যাক
এই বিভাগের প্রয়োজনীয়তাগুলি বিশেষভাবে এমবেড করা YouTube প্লেয়ারগুলির সাথে সম্পর্কিত৷ YouTube API পরিষেবা নীতিগুলিতে API ক্লায়েন্টগুলির সাথে প্রাসঙ্গিক বেশ কয়েকটি নীতি অন্তর্ভুক্ত রয়েছে যা YouTube অডিওভিজ্যুয়াল সামগ্রী চালায়।
এম্বেড করা YouTube প্লেয়ারের আকার
এমবেডেড প্লেয়ারের একটি ভিউপোর্ট থাকতে হবে যা কমপক্ষে 200px x 200px। প্লেয়ার যদি কন্ট্রোল প্রদর্শন করে, তাহলে ভিউপোর্টকে ন্যূনতম আকারের নিচে সঙ্কুচিত না করে নিয়ন্ত্রণগুলি সম্পূর্ণরূপে প্রদর্শনের জন্য যথেষ্ট বড় হতে হবে। আমরা 16:9 প্লেয়ারদের কমপক্ষে 480 পিক্সেল চওড়া এবং 270 পিক্সেল লম্বা হওয়ার পরামর্শ দিই।
অটোপ্লে এবং স্ক্রিপ্টেড প্লেব্যাক
এই বিভাগে স্বয়ংক্রিয় প্লেব্যাক কভার. এটি YouTube এম্বেড করা প্লেয়ারগুলির ক্ষেত্রে প্রযোজ্য যেগুলি হয় autoplay প্লেয়ার প্যারামিটার ব্যবহার করে বা YouTube IFrame Player API পরিষেবা, YouTube Android Player API পরিষেবা, বা অন্য YouTube API পরিষেবা ব্যবহার করে প্রোগ্রাম্যাটিকভাবে স্বয়ংক্রিয় প্লেব্যাক শুরু করে৷
এমবেড করা প্লেয়ার যেগুলি স্বয়ংক্রিয়ভাবে একটি ভিডিও চালায়, পৃষ্ঠাটি লোড হওয়ার সাথে সাথে বা এমবেড করা প্লেয়ারটি সম্পূর্ণরূপে দৃশ্যমান হওয়ার সাথে সাথেই প্লেব্যাক শুরু করা উচিত৷ যাইহোক, প্লেয়ারটি দৃশ্যমান না হওয়া পর্যন্ত এবং প্লেয়ারের অর্ধেকেরও বেশি পৃষ্ঠা বা স্ক্রিনে দৃশ্যমান না হওয়া পর্যন্ত একজন API ক্লায়েন্ট অবশ্যই একটি স্বয়ংক্রিয় প্লেব্যাক শুরু করবেন না।
একটি পৃষ্ঠা বা স্ক্রিনে একটির বেশি YouTube প্লেয়ার থাকা উচিত নয় যা স্বয়ংক্রিয়ভাবে একই সাথে সামগ্রী চালায়।
যেকোনো YouTube থাম্বনেইল যা প্লেব্যাক শুরু করে তা অবশ্যই কমপক্ষে 120 পিক্সেল চওড়া এবং 70 পিক্সেল লম্বা হতে হবে।
ইউটিউব প্লেয়ারের বৈশিষ্ট্য
YouTube প্লেয়ারের বৈশিষ্ট্য এবং পরামিতি - যেমন, প্লেয়ারে YouTube ব্র্যান্ডিংয়ের উপস্থিতি সহ - YouTube API ডকুমেন্টেশন এবং স্পেসিফিকেশনে (https://developers.google.com/youtube) নির্দিষ্ট করা আছে। আপনি অবশ্যই YouTube প্লেয়ারে এমন পরিবর্তন করবেন না যা API ডকুমেন্টেশন দ্বারা স্পষ্টভাবে বর্ণনা করা হয়নি।
ওভারলে এবং ফ্রেম
আপনি প্লেয়ার কন্ট্রোল সহ YouTube এম্বেড করা প্লেয়ারের যেকোনো অংশের সামনে ওভারলে, ফ্রেম বা অন্যান্য ভিজ্যুয়াল উপাদান প্রদর্শন করবেন না। একইভাবে, প্লেয়ার কন্ট্রোল সহ এমবেড করা প্লেয়ারের যেকোন অংশকে অস্পষ্ট করার জন্য আপনি অবশ্যই ওভারলে, ফ্রেম বা অন্যান্য ভিজ্যুয়াল উপাদান ব্যবহার করবেন না।
মাউসওভার
ইউটিউব প্লেয়ারে মাউসওভার বা টাচ ইভেন্ট ব্যবহার করা উচিত নয় ব্যবহারকারীর পক্ষ থেকে কোনো কাজ শুরু করার জন্য, যেমন একটি উইন্ডো খোলা বা চ্যানেলে সদস্যতা নেওয়া।
ভিডিও আপলোড করা হচ্ছে
যদি API ক্লায়েন্ট ব্যবহারকারীদের একাধিক প্ল্যাটফর্মে সামগ্রী আপলোড করার অনুমতি দেয়, ব্যবহারকারীরা তাদের ভিডিও আপলোড করতে চান এমন প্ল্যাটফর্মগুলি নির্বাচন এবং অনির্বাচন করতে সক্ষম হওয়া উচিত।
ডেটা প্রয়োজনীয়তা
API ক্লায়েন্ট যা ব্যবহারকারীদের YouTube-এ ভিডিও আপলোড করতে সক্ষম করে তাদের অবশ্যই ব্যবহারকারীদের নিম্নলিখিত তালিকায় মান সেট করতে সক্ষম করতে হবে। তালিকাভুক্ত নয় এমন কোনো বৈশিষ্ট্য ঐচ্ছিক।
| নাম | বর্ণনা | |
|---|---|---|
| সম্পদ বৈশিষ্ট্য | ||
snippet.title | প্রয়োজন ভিডিওটির শিরোনাম। মান 100 অক্ষরের বেশি হলে YouTube একটি ত্রুটি ফেরত দেয়। YouTube < এবং > ছাড়া সকল বৈধ UTF-8 অক্ষর সমর্থন করে। | |
snippet.description | প্রয়োজন ভিডিওটির বর্ণনা। মান 5000 বাইটের বেশি হলে YouTube একটি ত্রুটি ফেরত দেয়। YouTube < এবং > ছাড়া সকল বৈধ UTF-8 অক্ষর সমর্থন করে। | |
status.privacyStatus | প্রয়োজন ভিডিওটির গোপনীয়তা সেটিং । ব্যবহারকারীরা অবশ্যই আপলোড করা ভিডিওটি সর্বজনীন, ব্যক্তিগত বা তালিকাভুক্ত হবে কিনা তা চয়ন করতে সক্ষম হবেন৷ | |
| পরামিতি অনুরোধ | ||
onBehalfOfContentOwnerChannel | শর্তসাপেক্ষে প্রয়োজন । যদি অনুরোধের অনুমোদনের শংসাপত্রগুলি কোনও সামগ্রীর মালিককে সনাক্ত করে এবং onBehalfOfContentOwner প্যারামিটার সেট করা থাকে, তাহলে API ব্যবহারকারীকে অবশ্যই YouTube চ্যানেলটি নির্দিষ্ট করতে সক্ষম হতে হবে যেখানে ভিডিওটি আপলোড করা হচ্ছে৷ | |
মন্তব্য প্রদর্শন করা হচ্ছে
| নাম | বর্ণনা | |
|---|---|---|
| সম্পদ বৈশিষ্ট্য | ||
snippet.textDisplay | প্রয়োজন মন্তব্যের পাঠ্য। এপিআই ক্লায়েন্টকে অবশ্যই (ক) একটি মন্তব্য বা মন্তব্যের উত্তরের সম্পূর্ণ পাঠ্য প্রদর্শন করতে হবে, অথবা (খ) পাঠ্যটি ছেঁটে ফেলতে হবে এবং দর্শককে ছেঁটে যাওয়া সংস্করণ থেকে সম্পূর্ণ পাঠ্যটি সহজেই অ্যাক্সেস করার জন্য একটি উপায় প্রদান করতে হবে। এই প্রয়োজনীয়তাটি সমস্ত মন্তব্য এবং মন্তব্যের উত্তরের ক্ষেত্রে প্রযোজ্য, মন্তব্যগুলি যে ধরণের সংস্থানগুলির সাথে সম্পর্কিত (ভিডিও, চ্যানেল, ইত্যাদি) নির্বিশেষে। মনে রাখবেন commentThread রিসোর্সের snippet.topLevelComment প্রপার্টি ভ্যালু একটি comment রিসোর্স এবং replies.comments[] প্রপার্টি হল comment রিসোর্সের একটি তালিকা। যেমন, এই প্রয়োজনীয়তা snippet.topLevelComment.snippet.textDisplay এবং replies.comments[].snippet.textDisplay বৈশিষ্ট্যের ক্ষেত্রেও প্রযোজ্য। | |
snippet.title( channel ) | প্রয়োজনীয় (পরামর্শ) । চ্যানেলের শিরোনাম।
| |
snippet.title( video ) | শর্তসাপেক্ষে প্রয়োজন (পরামর্শ) । ভিডিওটির শিরোনাম। মন্তব্যটি ভিডিওর সাথে সম্পর্কিত হলে এই মানটি অবশ্যই প্রদর্শিত হবে৷ | |
snippet.moderationStatus | শর্তসাপেক্ষে প্রয়োজন । যদি API অনুরোধে moderationStatus প্যারামিটারের মানটি অনুষ্ঠিত হয় heldForReview বা likelySpam , তাহলে প্রদর্শনটিকে অবশ্যই সম্পত্তির মান, অনুরূপ ভাষা (যেমন "এই মন্তব্যটি পর্যালোচনার জন্য রাখা হচ্ছে"), একটি শিরোনাম (যেমন "পর্যালোচনার জন্য রাখা হয়েছে") ব্যবহার করে সেই স্থিতিটি স্পষ্টভাবে সনাক্ত করতে হবে। ), বা অন্যান্য দ্ব্যর্থহীন ভাষা। commentThreads.list পদ্ধতি তাদের সংযম অবস্থার উপর ভিত্তি করে মন্তব্য পুনরুদ্ধার করার ক্ষমতা সমর্থন করে। | |
মন্তব্য যোগ করা হচ্ছে
| নাম | বর্ণনা | |
|---|---|---|
| সম্পদ বৈশিষ্ট্য | ||
snippet.title( channel ) | প্রয়োজন চ্যানেলের শিরোনাম।
| |
snippet.title( video ) | প্রয়োজন যদি ব্যবহারকারী একটি ভিডিও সম্পর্কে একটি মন্তব্য যোগ করে, API ক্লায়েন্ট অবশ্যই ভিডিওটির শিরোনাম প্রদর্শন করবে৷ | |
| অন্যান্য প্রয়োজনীয়তা | ||
Comment author's channel name | প্রয়োজন API ক্লায়েন্টকে অবশ্যই স্পষ্টভাবে YouTube ব্যবহারকারী অ্যাকাউন্টটি সনাক্ত করতে হবে যেখানে মন্তব্যটি আরোপিত হবে৷ যদি অনুরোধের অনুমোদনের শংসাপত্রগুলি কোনও সামগ্রীর মালিককে সনাক্ত করে এবং onBehalfOfContentOwner প্যারামিটার সেট করা থাকে, তাহলে API ব্যবহারকারীকে অবশ্যই YouTube চ্যানেল নির্দিষ্ট করতে সক্ষম হতে হবে যেখানে মন্তব্যটি আরোপিত হবে৷ | |
মন্তব্য উত্তর যোগ করা হচ্ছে
| নাম | বর্ণনা | |
|---|---|---|
| সম্পদ বৈশিষ্ট্য | ||
snippet.textDisplay | প্রয়োজন মন্তব্যের পাঠ্য। API ক্লায়েন্টকে অবশ্যই মন্তব্যের পাঠ্য প্রদর্শন করতে হবে যা ব্যবহারকারী এই নথির প্রদর্শন মন্তব্য বিভাগে সংজ্ঞায়িত নিয়ম অনুসারে উত্তর দিচ্ছেন। | |
snippet.title( channel ) | প্রয়োজন চ্যানেলের শিরোনাম।
| |
snippet.title( video ) | প্রয়োজন যদি ব্যবহারকারী একটি ভিডিও সম্পর্কে একটি মন্তব্যের উত্তর দেয়, তাহলে API ক্লায়েন্টকে অবশ্যই ভিডিওটির শিরোনাম প্রদর্শন করতে হবে। | |
| অন্যান্য প্রয়োজনীয়তা | ||
Comment author's channel name | প্রয়োজন API ক্লায়েন্টকে অবশ্যই স্পষ্টভাবে YouTube ব্যবহারকারী অ্যাকাউন্টটি সনাক্ত করতে হবে যেখানে মন্তব্যের উত্তরটি দায়ী করা হবে৷ যদি অনুরোধের অনুমোদনের শংসাপত্রগুলি কোনও সামগ্রীর মালিককে সনাক্ত করে এবং onBehalfOfContentOwner প্যারামিটার সেট করা থাকে, তাহলে API ব্যবহারকারীকে অবশ্যই YouTube চ্যানেলটি নির্দিষ্ট করতে সক্ষম হতে হবে যেখানে মন্তব্যের উত্তরটি দায়ী করা হবে৷ | |
মন্তব্যের উত্তর সম্পাদনা বা মুছে ফেলা
| নাম | বর্ণনা | |
|---|---|---|
| সম্পদ বৈশিষ্ট্য | ||
snippet.textDisplay | প্রয়োজন মন্তব্যের পাঠ্য। API ক্লায়েন্টকে অবশ্যই মন্তব্যের পাঠ্য প্রদর্শন করতে হবে যা ব্যবহারকারী এই নথির প্রদর্শন মন্তব্য বিভাগে সংজ্ঞায়িত নিয়ম অনুসারে সম্পাদনা বা মুছে ফেলছেন। | |
snippet.title( channel ) | প্রয়োজন চ্যানেলের শিরোনাম।
| |
snippet.title( video ) | প্রয়োজন যদি ব্যবহারকারী একটি ভিডিও সম্পর্কে একটি মন্তব্য সম্পাদনা বা মুছে ফেলে, তাহলে API ক্লায়েন্টকে অবশ্যই ভিডিওটির শিরোনাম প্রদর্শন করতে হবে। | |
| অন্যান্য প্রয়োজনীয়তা | ||
Comment author's channel name | প্রয়োজন API ক্লায়েন্টকে অবশ্যই স্পষ্টভাবে YouTube ব্যবহারকারী অ্যাকাউন্টটি সনাক্ত করতে হবে যেখানে মন্তব্যটি দায়ী করা হয়েছে৷ | |
একজন ব্যবহারকারীকে লাইভ চ্যাট থেকে নিষিদ্ধ করা (বা একটি নিষেধাজ্ঞা সরানো)
| নাম | বর্ণনা | |
|---|---|---|
| সম্পদ বৈশিষ্ট্য | ||
snippet.title( channel ) | প্রয়োজন যে ইউটিউব চ্যানেলটিকে নিষিদ্ধ বা নিষিদ্ধ করা হচ্ছে তার নাম। এছাড়াও, নামটি অবশ্যই চ্যানেলের সাথে লিঙ্ক করতে হবে বা চ্যানেলের URLটিও প্রদর্শন করতে হবে। | |
| অন্যান্য প্রয়োজনীয়তা | ||
| মন্তব্য লেখকের চ্যানেলের নাম | প্রয়োজন এপিআই ক্লায়েন্টকে অবশ্যই স্পষ্টভাবে সনাক্ত করতে হবে যে YouTube ব্যবহারকারী অ্যাকাউন্টটি নিষেধাজ্ঞা যোগ করতে বা সরাতে ব্যবহার করা হচ্ছে। | |