YouTube API পরিষেবাগুলি - প্রয়োজনীয় ন্যূনতম কার্যকারিতা৷

দ্রষ্টব্য: 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 অডিওভিজ্যুয়াল সামগ্রী চালায়।

API ক্লায়েন্ট আইডেন্টিটি এবং শংসাপত্র

API ক্লায়েন্ট যারা YouTube এম্বেডেড প্লেয়ার ব্যবহার করে (YouTube IFrame Player API সহ) HTTP Referer অনুরোধ শিরোনামের মাধ্যমে সনাক্তকরণ প্রদান করতে হবে। কিছু পরিবেশে, ব্রাউজার স্বয়ংক্রিয়ভাবে HTTP Referer সেট করবে, এবং API ক্লায়েন্টদের শুধুমাত্র নিশ্চিত করতে হবে যে তারা Referrer-Policy এমনভাবে সেট করছে না যা Referer মানকে দমন করে। YouTube strict-origin-when-cross-origin রেফারার-নীতি ব্যবহার করার পরামর্শ দেয়, যা অনেক ব্রাউজারে ইতিমধ্যেই ডিফল্ট।

একইভাবে, JavaScript window.open ব্যবহার করে তৈরি একটি উইন্ডোতে YouTube এম্বেড করা প্লেয়ারকে একীভূত করলে, API ক্লায়েন্টদের অবশ্যই noreferrer বৈশিষ্ট্য ব্যবহার করা উচিত নয়, যা Referer মানকে দমন করে।

রেফারার সেট করুন

যে পরিবেশে HTTP Referer ডিফল্টরূপে খালি থাকে এবং ব্রাউজার দ্বারা স্বয়ংক্রিয়ভাবে সেট করা হয় না, API ক্লায়েন্টদের অবশ্যই বিকল্প উপায়ে তাদের পরিচয় প্রদানের জন্য পদক্ষেপ নিতে হবে। WebView ইন্টিগ্রেশন যেমন একটি মোবাইল অ্যাপ বা ডেস্কটপ অ্যাপে, HTTP Referer ডিফল্টরূপে খালি থাকে এবং Referer সাধারণত এই কৌশলগুলির একটি ব্যবহার করে সেট করা হয়:

• একটি স্থানীয় HTML ফাইলের ভিতরে প্লেয়ার সহ মোবাইল অ্যাপ

  এই কনফিগারেশনে, প্লেয়ারটিকে একটি HTML ফাইলে লোড করা হয় যা অ্যাপটির সাথে বান্ডিল করা হয়। এই HTML ফাইলটি লোড করার সময়, baseUrl প্যারামিটার সেট করা Referer সেট করবে।

  • Android loadDataWithBaseURL
  • iOS loadHTMLString:baseURL:

• স্থানীয় HTML ফাইল ছাড়া মোবাইল অ্যাপ

  এই কনফিগারেশনে, প্লেয়ারটি সরাসরি https://www.youtube.com/embed/VIDEO_ID থেকে লোড করা হয় কোনো এনক্লোজিং HTML ফাইল ছাড়াই। আপনি একটি HTTP শিরোনাম হিসাবে এটি যোগ করে Referer সেট করুন:

  • Referer HTTP হেডার সহ Android loadUrl additionalHttpHeaders প্যারামিটারে যোগ করা হয়েছে

  • iOS loadRequest: অনুরোধের সাথে Referer HTTP হেডার যোগ করা হয়েছে। যেমন:

    NSString *bundleId = [[NSBundle mainBundle] bundleIdentifier];
    NSString *referrer = [[NSString stringWithFormat:@"https://%@", bundleId] lowercaseString];
    NSURL *referrerUrl = [NSURL URLWithString:referrer];
    
    NSString *destination = @"https://www.youtube.com/embed/VIDEO_ID";
    NSURL *destinationUrl = [NSURL URLWithString:destination];
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:destinationUrl];
    [request addValue:referrerUrl forHTTPHeaderField:@"Referer"];
    
    // Create an instance of WKWebView (omitted for simplicity), then load the NSMutableURLRequest.
    [webView loadRequest:request];
    

• একটি নেটিভ ব্রাউজার ট্যাবের ভিতরে প্লেয়ার সহ মোবাইল অ্যাপ

  • অ্যান্ড্রয়েড CustomTabs

    রেফারার সেট করতে Intent.EXTRA_REFERRER ব্যবহার করুন। Uri তৈরি করার সময় https:// এর পরিবর্তে android-app:// স্কিম ব্যবহার করতে ভুলবেন না। যেমন:

    String destinationUrl = "https://www.youtube.com/embed/VIDEO_ID";
    CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder().build()
    customTabsIntent.intent.putExtra(Intent.EXTRA_REFERRER, Uri.parse("android-app://" + context.getPackageName()));
    customTabsIntent.launchUrl(this, Uri.parse(destinationUrl));
    

  • iOS SFSafariViewController

    SFSafariViewController Referer সেট করা সমর্থন করে না। এই ক্ষেত্রে, পরিবর্তে origin প্লেয়ার প্যারামিটার সেট করুন।

• ডেস্কটপ অ্যাপ

  এই কনফিগারেশনে, একটি HTTP হেডার হিসাবে এটি যোগ করে Referer সেট করুন:

  • Microsoft .NET - HttpRequestHeaders.Referrer বা CoreWebView2HttpRequestHeaders.SetHeader ব্যবহার করুন
  • macOS - iOS মোবাইল অ্যাপগুলির জন্য উপরে বর্ণিত একই নির্দেশাবলী অনুসরণ করুন

অন্যান্য প্ল্যাটফর্মের জন্য যেখানে HTTP Referer ডিফল্টভাবে খালি থাকে, প্লেয়ারটি লোড করা ওয়েবভিউ কনফিগার করে Referer মান সেট করুন। সঠিক কৌশলটি প্ল্যাটফর্ম অনুসারে পরিবর্তিত হতে পারে।

আপনি যদি YouTube এম্বেড করা প্লেয়ারকে সংহত করার জন্য ডেভেলপারদের দ্বারা ব্যবহৃত একটি লাইব্রেরি, ফ্রেমওয়ার্ক, প্লাগইন, পরিষেবা বা মোড়কের মালিক হন, তাহলে আপনাকে অবশ্যই পরিবেশ থেকে অ্যাপ আইডি পুনরুদ্ধার করতে হবে (প্ল্যাটফর্মের উপর নির্ভর করে এটি সম্ভব নাও হতে পারে) অথবা ডেভেলপারদের তাদের অ্যাপ আইডি পাস-ইন করার অনুমতি দিতে হবে যাতে Referer (এবং widget_referrer যদি উপরে বর্ণিত প্লেয়ার প্যারামিটার হিসাবে উপযুক্ত) বর্ণনা করা যায়।

রেফারার বিন্যাস

যখন আপনি একটি WebView প্যারামিটার সেট করে বা একটি HTTP হেডার যোগ করে স্পষ্টভাবে রেফারার প্রদান করেন, তখন ফর্ম্যাটটি সাধারণত একটি সম্পূর্ণ যোগ্য URL হয়। প্রোটোকল হিসাবে HTTPS নির্দিষ্ট করুন। URL-এর মধ্যে, ডোমেন নামটি অবশ্যই আপনার অ্যাপ্লিকেশন শনাক্তকারী ("অ্যাপ আইডি") হতে হবে যা সেই স্টোরের সাথে নিবন্ধিত যেটি আপনার অ্যাপটি শেষ ব্যবহারকারীদের কাছে বিতরণ করেছে৷ যদি আপনার অ্যাপটি একটি বিকল্প বিতরণ চ্যানেলের মাধ্যমে ব্যবহারকারীদের প্রদান করা হয়, তাহলে অ্যাপ ইনস্টল করার সময় অপারেটিং সিস্টেমে নিবন্ধিত অ্যাপ আইডি ব্যবহার করুন। বেশিরভাগ ক্ষেত্রে, আপনার অ্যাপ আইডি হবে একটি বিপরীত ডোমেন নাম ("বিপরীত-ডিএনএস ফর্ম্যাট" নামেও পরিচিত), যেমন com.google.android.youtube । প্রতিনিধি উদাহরণ:

• ChromeOS-এ Android OS এবং Android অ্যাপ: অ্যাপ আইডি
• iOS, iPadOS, macOS সহ Apple প্ল্যাটফর্মগুলি: বান্ডেল আইডি
• Samsung Tizen: অ্যাপ আইডি
• লিনাক্স বিতরণ:
  • ফেডোরা: অ্যাপ আইডি
  • জিনোম: অ্যাপ আইডি
  • উবুন্টু: অ্যাপ আইডি

কিছু প্ল্যাটফর্মে অ্যাপ আইডি একটি বিপরীত ডোমেন নাম নয়। এই ক্ষেত্রে, স্টোর যে অ্যাপটি বিতরণ করে তার দ্বারা নির্ধারিত অনন্য অ্যাপ আইডি ব্যবহার করুন। যখন স্টোর অ্যাপ আইডি একটি জেনারেট করা আলফানিউমেরিক স্ট্রিং হয় (স্টোর বা ডেভেলপমেন্ট টুল দ্বারা অ্যাসাইন করা হয়, অ্যাপ ডেভেলপার দ্বারা বাছাই করা হয় না), তখন অ্যাপ ডিসপ্লে নাম (হাইফেন দিয়ে স্পেস প্রতিস্থাপন) এবং স্টোর অ্যাপ আইডি উভয়ই অন্তর্ভুক্ত করুন, একটি পিরিয়ড দ্বারা সীমাবদ্ধ। যেমন: <my-app-name>.<AppID> । এই মানটি অ্যাপ সংস্করণ পরিবর্তন জুড়ে স্থিতিশীল হওয়া উচিত। অ্যাপটি কোনো স্টোরে হোস্ট করা না থাকলে, অ্যাপ ইনস্টল করার সময় অপারেটিং সিস্টেমে নিবন্ধিত অ্যাপ আইডি ব্যবহার করুন; এটি সাধারণত অ্যাপ ম্যানিফেস্টে একটি অনন্য শনাক্তকারী। অ্যাপ সংস্করণ এবং সমর্থিত আর্কিটেকচার সম্পর্কে কোনো বিবরণ বাদ দিন। প্রতিনিধি উদাহরণ:

• ক্রোম ওয়েব স্টোর: স্টোর-হোস্টেড

  স্টোর অ্যাপ আইডিটি সাধারণত অ্যাপ ইউআরএল https://chromewebstore.google.com/detail/<hyphenated-app-name>/<AppID> এর পাথের শেষ অংশ। উপরে বর্ণিত <my-app-name>.<AppID>

• উইন্ডোজ: স্টোর-হোস্টেড

  স্টোর অ্যাপ আইডি সাধারণত অ্যাপ ইউআরএল https://apps.microsoft.com/detail/<AppID> এর পাথের শেষ অংশ। উপরে বর্ণিত <my-app-name>.<AppID> হাইফেনযুক্ত অ্যাপের নামও অবশ্যই অন্তর্ভুক্ত করতে হবে।

• উইন্ডোজ: অ-স্টোর বিতরণ

  উইন্ডোজ অ্যাপের অ্যাপ ম্যানিফেস্টে একটি প্যাকেজ পরিচয় থাকে: Name_Version_Architecture_ResourceID_PublisherID । শুধুমাত্র Name বৈশিষ্ট্য ব্যবহার করুন.

• এক্সবক্স: স্টোর-হোস্টেড

  স্টোর অ্যাপ আইডি সাধারণত অ্যাপ ইউআরএল https://www.xbox.com/<region>/games/store/<hyphenated-app-name>/<AppID> এর পাথের শেষ অংশ। উপরে বর্ণিত <my-app-name>.<AppID>

এপিআই ক্লায়েন্টদের জন্য ইউটিউবে প্রচুর অনুরোধ সহ ( ব্যবহার এবং কোটা দেখুন), YouTube এম্বেড করা প্লেয়ার অ্যাক্সেস করার জন্য অতিরিক্ত শংসাপত্রের প্রয়োজন হতে পারে।

এই প্রয়োজনীয়তাগুলি মেনে চলতে ব্যর্থ হলে YouTube এম্বেড করা প্লেয়ারের কার্যকারিতা হ্রাস পেতে পারে।

ওয়েবভিউ টাইপ

একটি WebView-এ YouTube এম্বেড করা প্লেয়ারকে সংহত করার সময়, উপলব্ধ হলে OS-প্রদত্ত ওয়েবভিউ প্রকারগুলির একটি ব্যবহার করুন৷ যেমন:

• অ্যান্ড্রয়েড ওএস: WebView বা CustomTabs
• iOS, iPadOS, macOS সহ Apple প্ল্যাটফর্ম: WKWebView বা SFSafariViewController

এম্বেড করা YouTube প্লেয়ারের আকার

এমবেডেড প্লেয়ারের একটি ভিউপোর্ট থাকতে হবে যা কমপক্ষে 200px x 200px। প্লেয়ার যদি কন্ট্রোল প্রদর্শন করে, তাহলে ভিউপোর্টকে ন্যূনতম আকারের নিচে সঙ্কুচিত না করে নিয়ন্ত্রণগুলি সম্পূর্ণরূপে প্রদর্শনের জন্য যথেষ্ট বড় হতে হবে। আমরা 16:9 প্লেয়ারদের কমপক্ষে 480 পিক্সেল চওড়া এবং 270 পিক্সেল লম্বা হওয়ার পরামর্শ দিই।

অটোপ্লে এবং স্ক্রিপ্টেড প্লেব্যাক

এই বিভাগে স্বয়ংক্রিয় প্লেব্যাক কভার. এটি YouTube এম্বেড করা প্লেয়ারগুলির ক্ষেত্রে প্রযোজ্য যেগুলি হয় autoplay প্লেয়ার প্যারামিটার ব্যবহার করে বা YouTube IFrame Player API পরিষেবা বা অন্য YouTube API পরিষেবা ব্যবহার করে প্রোগ্রাম্যাটিকভাবে স্বয়ংক্রিয় প্লেব্যাক শুরু করে৷

• এমবেড করা প্লেয়ার যেগুলি স্বয়ংক্রিয়ভাবে একটি ভিডিও চালায়, পৃষ্ঠাটি লোড হওয়ার সাথে সাথে বা এমবেড করা প্লেয়ারটি সম্পূর্ণরূপে দৃশ্যমান হওয়ার সাথে সাথেই প্লেব্যাক শুরু করা উচিত৷ যাইহোক, প্লেয়ারটি দৃশ্যমান না হওয়া পর্যন্ত এবং প্লেয়ারের অর্ধেকেরও বেশি পৃষ্ঠা বা স্ক্রিনে দৃশ্যমান না হওয়া পর্যন্ত একজন API ক্লায়েন্ট অবশ্যই একটি স্বয়ংক্রিয় প্লেব্যাক শুরু করবেন না।

• একটি পৃষ্ঠা বা স্ক্রিনে একটির বেশি YouTube প্লেয়ার থাকা উচিত নয় যা স্বয়ংক্রিয়ভাবে একই সাথে সামগ্রী চালায়।

• যেকোনো YouTube থাম্বনেইল যা প্লেব্যাক শুরু করে তা অবশ্যই কমপক্ষে 120 পিক্সেল চওড়া এবং 70 পিক্সেল লম্বা হতে হবে।

ইউটিউব প্লেয়ারের বৈশিষ্ট্য

YouTube প্লেয়ারের বৈশিষ্ট্য এবং পরামিতি - যেমন, প্লেয়ারে YouTube ব্র্যান্ডিংয়ের উপস্থিতি সহ - YouTube API ডকুমেন্টেশন এবং স্পেসিফিকেশনে (https://developers.google.com/youtube) নির্দিষ্ট করা আছে। আপনি অবশ্যই YouTube প্লেয়ারে এমন পরিবর্তন করবেন না যা API ডকুমেন্টেশন দ্বারা স্পষ্টভাবে বর্ণনা করা হয়নি।

ওভারলে এবং ফ্রেম

আপনি প্লেয়ার কন্ট্রোল সহ YouTube এম্বেড করা প্লেয়ারের যেকোনো অংশের সামনে ওভারলে, ফ্রেম বা অন্যান্য ভিজ্যুয়াল উপাদান প্রদর্শন করবেন না। একইভাবে, প্লেয়ার কন্ট্রোল সহ এমবেড করা প্লেয়ারের যেকোন অংশকে অস্পষ্ট করার জন্য আপনি অবশ্যই ওভারলে, ফ্রেম বা অন্যান্য ভিজ্যুয়াল উপাদান ব্যবহার করবেন না।

মাউসওভার

ইউটিউব প্লেয়ারে মাউসওভার বা টাচ ইভেন্ট ব্যবহার করা উচিত নয় ব্যবহারকারীর পক্ষ থেকে কোনো কাজ শুরু করার জন্য, যেমন একটি উইন্ডো খোলা বা চ্যানেলে সদস্যতা নেওয়া।

ভিডিও আপলোড করা হচ্ছে

যদি API ক্লায়েন্ট ব্যবহারকারীদের একাধিক প্ল্যাটফর্মে সামগ্রী আপলোড করার অনুমতি দেয়, ব্যবহারকারীরা তাদের ভিডিও আপলোড করতে চান এমন প্ল্যাটফর্মগুলি নির্বাচন এবং অনির্বাচন করতে সক্ষম হওয়া উচিত।

ডেটা প্রয়োজনীয়তা

API ক্লায়েন্ট যা ব্যবহারকারীদের YouTube-এ ভিডিও আপলোড করতে সক্ষম করে তাদের অবশ্যই ব্যবহারকারীদের নিম্নলিখিত তালিকায় মান সেট করতে সক্ষম করতে হবে। তালিকাভুক্ত নয় এমন কোনো বৈশিষ্ট্য ঐচ্ছিক।

মন্তব্য প্রদর্শন করা হচ্ছে

মন্তব্য যোগ করা হচ্ছে

মন্তব্য উত্তর যোগ করা হচ্ছে

মন্তব্যের উত্তর সম্পাদনা বা মুছে ফেলা

একজন ব্যবহারকারীকে লাইভ চ্যাট থেকে নিষিদ্ধ করা (বা একটি নিষেধাজ্ঞা সরানো)