এই দস্তাবেজটি ইউটিউব অ্যানালিটিক্স এপিআই এবং ইউটিউব রিপোর্টিং এপিআই ইউটিউব অ্যানালিটিক্স ডেটাতে অ্যাক্সেস প্রদান করার উপায়ে মিল এবং পার্থক্য ব্যাখ্যা করে, যাতে আপনি আপনার অ্যাপ্লিকেশনের জন্য সঠিক API বেছে নিতে পারেন।
উভয় APIই আপনাকে YouTube Analytics ডেটা পুনরুদ্ধার করতে দেয়। উপরন্তু, উভয় APIই YouTube চ্যানেলের মালিক এবং YouTube বিষয়বস্তুর মালিকদের সমর্থন করে, যাদের প্রত্যেকেই রিপোর্টের একটি নির্দিষ্ট সেট অ্যাক্সেস করতে পারে:
চ্যানেল রিপোর্টে একটি নির্দিষ্ট চ্যানেলের জন্য ব্যবহারকারীর কার্যকলাপ মেট্রিক্স থাকে।
বিষয়বস্তুর মালিক একটি নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা সমস্ত চ্যানেলের জন্য সমষ্টিগত মেট্রিক্স রিপোর্ট করে ৷ উদাহরণস্বরূপ, একটি রেকর্ড লেবেল সমস্ত লেবেলের শিল্পীদের YouTube চ্যানেলের সম্মিলিত পরিসংখ্যান সমন্বিত একটি প্রতিবেদন পুনরুদ্ধার করতে পারে৷ কিছু বিষয়বস্তুর মালিকের প্রতিবেদনে ব্যবহারকারীর কার্যকলাপের মেট্রিক থাকে, অন্যগুলিতে আয় এবং বিজ্ঞাপনের কর্মক্ষমতা সম্পর্কিত মেট্রিক থাকে।
রিপোর্টিং এপিআই কিছু বিষয়বস্তুর মালিকদের সিস্টেম-পরিচালিত বিজ্ঞাপন আয়ের রিপোর্ট অ্যাক্সেস করার অনুমতি দেয়। সিস্টেম-পরিচালিত প্রতিবেদনের ডেটা শুধুমাত্র রিপোর্টিং API দিয়ে পুনরুদ্ধার করা যেতে পারে।
সমস্ত ইউটিউব অ্যানালিটিক্স এবং ইউটিউব রিপোর্টিং API অনুরোধ অবশ্যই অনুরোধকৃত ডেটার মালিক চ্যানেল বা বিষয়বস্তুর মালিকের দ্বারা অনুমোদিত হতে হবে৷
বিষয়বস্তু রিপোর্ট
API গুলি যে রিপোর্টগুলি পুনরুদ্ধার করে তাতে দুটি ধরণের ডেটা থাকে:
মাত্রাগুলি হল সাধারণ মানদণ্ড যা ডেটা একত্রিত করতে ব্যবহৃত হয়, যেমন ব্যবহারকারীর কার্যকলাপের তারিখ বা ব্যবহারকারীরা যে দেশে অবস্থিত ছিল।
একটি প্রতিবেদনে, ডেটার প্রতিটি সারিতে মাত্রা মানগুলির একটি অনন্য সমন্বয় রয়েছে। যেমন, প্রতিটি সারির মাত্রা মানগুলির সংমিশ্রণ সেই সারির প্রাথমিক কী হিসাবে কাজ করে।
মেট্রিক্স হল ব্যবহারকারীর কার্যকলাপ, বিজ্ঞাপনের কার্যকারিতা বা আনুমানিক আয়ের পৃথক পরিমাপ। ব্যবহারকারীর ক্রিয়াকলাপ মেট্রিক্সে ভিডিও দেখার সংখ্যা এবং রেটিং (পছন্দ এবং অপছন্দ) এর মতো বিষয়গুলি অন্তর্ভুক্ত থাকে।
আপনার অ্যাপ্লিকেশনের জন্য সঠিক API চয়ন করুন
- YouTube Analytics API
- ইউটিউব অ্যানালিটিক্স এপিআই কাস্টম ইউটিউব অ্যানালিটিক্স রিপোর্ট তৈরি করতে রিয়েল-টাইম টার্গেট করা প্রশ্নগুলিকে সমর্থন করে৷ API ফিল্টারিং এবং বাছাই পরামিতি প্রদান করে, তাই কলিং অ্যাপ্লিকেশনটিকে এই ফাংশনগুলিকে স্থানীয়ভাবে সমর্থন করার প্রয়োজন নেই।
প্রতিটি API অনুরোধ তারিখ পরিসীমা নির্দিষ্ট করে যার জন্য ডেটা ফেরত দেওয়া হবে। এপিআই আপনাকে সাপ্তাহিক এবং মাসিক ডেটা সেট পুনরুদ্ধার করতে দেয়। যেমন, কলিং অ্যাপ্লিকেশনটিকে পুনরুদ্ধার করা ডেটা সেট বা তারিখের ব্যাপ্তি জুড়ে মোট পরিসংখ্যান সংরক্ষণ করার প্রয়োজন নেই। - YouTube রিপোর্টিং API
- YouTube রিপোর্টিং API একটি চ্যানেল বা বিষয়বস্তুর মালিকের জন্য YouTube Analytics ডেটা সমন্বিত বাল্ক রিপোর্ট পুনরুদ্ধার করে। এটি এমন অ্যাপ্লিকেশনগুলির জন্য ডিজাইন করা হয়েছে যা বড় ডেটা সেট আমদানি করতে পারে এবং যেগুলি ডেটা ফিল্টার, বাছাই এবং মাইন করার জন্য সরঞ্জাম সরবরাহ করে।
প্রতিটি প্রতিবেদনে ক্ষেত্রগুলির একটি পূর্বনির্ধারিত সেট রয়েছে। আপনি রিপোর্টিং কাজের সময়সূচী করতে API ব্যবহার করেন, যার প্রত্যেকটি YouTube-এর তৈরি করা উচিত এমন একটি প্রতিবেদন শনাক্ত করে। YouTube তারপর একটি দৈনিক প্রতিবেদন তৈরি করে যা অ্যাসিঙ্ক্রোনাসভাবে ডাউনলোড করা যেতে পারে। প্রতিটি প্রতিবেদনে একটি অনন্য 24-ঘন্টা সময়ের জন্য ডেটা থাকে।
এছাড়াও, YouTube স্বয়ংক্রিয়ভাবে সামগ্রীর মালিকদের জন্য সিস্টেম-পরিচালিত প্রতিবেদনের একটি সেট তৈরি করে যাদের YouTube ক্রিয়েটর স্টুডিওতে সংশ্লিষ্ট প্রতিবেদনগুলিতে অ্যাক্সেস রয়েছে। এই প্রতিবেদনগুলি বিজ্ঞাপনের আয়ের ডেটাতে প্রোগ্রাম্যাটিক অ্যাক্সেস সরবরাহ করে।
সমর্থিত রিপোর্ট
নিম্নলিখিত সারণীটি বিভিন্ন ধরণের প্রতিবেদনগুলি চিহ্নিত করে যা আপনি API ব্যবহার করে পুনরুদ্ধার করতে পারেন৷ ইউটিউব অ্যানালিটিক্স এপিআই ব্যবহার করে টার্গেটেড ক্যোয়ারী পাওয়া যায় এবং ইউটিউব রিপোর্টিং এপিআই ব্যবহার করে বাল্ক রিপোর্ট পাওয়া যায়।
একটি API-এ উপলব্ধ ডেটা অন্যটিতে উপলব্ধ নাও হতে পারে। উদাহরণ স্বরূপ, YouTube Analytics API আপনাকে সাপ্তাহিক বা মাসিক ভিত্তিতে ব্যবহারকারীর কার্যকলাপের মেট্রিক পুনরুদ্ধার করতে দেয়, কিন্তু YouTube রিপোর্টিং API-এর জন্য আপনাকে সেই ডেটা নিজেই একত্রিত করতে হবে। অন্যদিকে, YouTube রিপোর্টিং API সামগ্রীর মালিকদের জন্য সম্পদ প্রতিবেদন সমর্থন করে, কিন্তু সেই ডেটা YouTube Analytics API থেকে পাওয়া যায় না।
| রিপোর্টের ধরন | |
|---|---|
| ভিডিও প্রতিবেদন | চ্যানেল ( কোয়েরি বা বাল্ক ) এবং বিষয়বস্তুর মালিকদের ( ক্যোয়ারী বা বাল্ক ) জন্য সমর্থিত। ভিডিও প্রতিবেদনগুলি একটি চ্যানেলের ভিডিও বা সামগ্রী মালিকের ভিডিওগুলির সাথে সম্পর্কিত সমস্ত ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে৷ উদাহরণস্বরূপ, এই প্রতিবেদনগুলিতে আপনার ভিডিওগুলি প্রাপ্ত দেখার সংখ্যা রয়েছে৷ YouTube Analytics এপিআই-এ, কিছু বিষয়বস্তুর মালিকের ভিডিও প্রতিবেদনে আনুমানিক আয় এবং বিজ্ঞাপন কার্য সম্পাদনের মেট্রিক্সও অন্তর্ভুক্ত থাকে। |
| প্লেলিস্ট রিপোর্ট | চ্যানেল ( কোয়েরি বা বাল্ক ) এবং বিষয়বস্তুর মালিকদের ( ক্যোয়ারী বা বাল্ক ) জন্য সমর্থিত। প্লেলিস্ট রিপোর্টগুলি এমন পরিসংখ্যান প্রদান করে যা বিশেষভাবে একটি প্লেলিস্টের প্রেক্ষাপটে ঘটে যাওয়া ভিডিও ভিউগুলির সাথে সম্পর্কিত৷ YouTube রিপোর্টিং API প্লেলিস্টের জন্য শ্রোতা ধরে রাখার প্রতিবেদন সমর্থন করে, কিন্তু YouTube Analytics API অনুরূপ প্রতিবেদন সমর্থন করে না। |
| বিজ্ঞাপন কর্মক্ষমতা রিপোর্ট | বিষয়বস্তুর মালিকদের জন্য সমর্থিত ( কোয়েরি বা বাল্ক )। বিজ্ঞাপনের কর্মক্ষমতা প্রতিবেদনগুলি ভিডিও প্লেব্যাকের সময় চলা বিজ্ঞাপনগুলির জন্য ইম্প্রেশন-ভিত্তিক মেট্রিক্স প্রদান করে। এই মেট্রিক্স প্রতিটি বিজ্ঞাপন ইম্প্রেশনের জন্য হিসাব করে এবং প্রতিটি ভিডিও প্লেব্যাক একাধিক ইমপ্রেশন দিতে পারে। |
| আনুমানিক রাজস্ব প্রতিবেদন | বিষয়বস্তুর মালিকদের জন্য সমর্থিত ( বাল্ক )। আনুমানিক রাজস্ব প্রতিবেদনগুলি Google-বিক্রীত বিজ্ঞাপন উত্স এবং অ-বিজ্ঞাপন উত্স থেকে ভিডিওগুলির জন্য মোট আনুমানিক আয় প্রদান করে৷ এই রিপোর্টে কিছু বিজ্ঞাপন কার্যক্ষমতার মেট্রিক্সও রয়েছে। মনে রাখবেন যে সিস্টেম-পরিচালিত প্রতিবেদনে প্রকৃত আয় থাকে। |
| সম্পদ রিপোর্ট | বিষয়বস্তুর মালিকদের জন্য সমর্থিত ( বাল্ক )। সম্পদের প্রতিবেদনগুলি এমন ভিডিওগুলির সাথে সম্পর্কিত ব্যবহারকারীর কার্যকলাপের মেট্রিক্স প্রদান করে যা একটি বিষয়বস্তুর মালিকের সম্পদের সাথে লিঙ্ক করা হয়। একটি ভিডিও একটি বিষয়বস্তুর মালিকের প্রতিবেদনে অন্তর্ভুক্ত করা হয় যদি বিষয়বস্তুর মালিক সেই ভিডিওটিকে বিষয়বস্তুর মালিকের সম্পদগুলির একটির সাথে মিল হিসাবে দাবি করে থাকে৷ ভিডিওটি সামগ্রীর মালিক বা অন্য YouTube ব্যবহারকারী দ্বারা আপলোড করা হতে পারে৷ |
| সিস্টেম-পরিচালিত প্রতিবেদন | YouTube-এর ক্রিয়েটর স্টুডিওর রিপোর্ট মেনুতে সংশ্লিষ্ট রিপোর্টগুলিতে অ্যাক্সেস আছে এমন সামগ্রী মালিকদের জন্য সমর্থিত। সিস্টেম-পরিচালিত রিপোর্ট সম্পদ এবং ভিডিও দ্বারা অর্জিত প্রকৃত রাজস্ব ডেটা প্রদান করে। একটি অতিরিক্ত রিপোর্ট দাবি করা ভিডিও এবং সেই ভিডিওগুলির সাথে মিলে যাওয়া সম্পদের তালিকা করে৷ সমস্ত ক্রিয়েটর স্টুডিও রিপোর্ট API-এ উপলব্ধ নয়। দ্রষ্টব্য: YouTube স্বয়ংক্রিয়ভাবে কন্টেন্ট মালিকদের জন্য সিস্টেম-পরিচালিত প্রতিবেদন তৈরি করে যাদের ক্রিয়েটর স্টুডিওতে সংশ্লিষ্ট প্রতিবেদনগুলিতে অ্যাক্সেস রয়েছে। ফলস্বরূপ, এই প্রতিবেদনগুলি পুনরুদ্ধার করার প্রক্রিয়াটি এই তালিকার অন্যান্য ধরণের প্রতিবেদনগুলির থেকে আলাদা৷ আরও তথ্যের জন্য সিস্টেম-পরিচালিত প্রতিবেদনের ডকুমেন্টেশন দেখুন। |
মূল পার্থক্য
নিচের সারণীটি YouTube Analytics এবং রিপোর্টিং API-এর মধ্যে গুরুত্বপূর্ণ পার্থক্য তুলে ধরে।
| বৈশিষ্ট্য | YouTube Analytics API | YouTube রিপোর্টিং API |
|---|---|---|
| ডেটা পুনরুদ্ধার করার প্রক্রিয়া | প্রতিটি এপিআই অনুরোধে ডাটা ফেরত দেওয়া হবে সেই সময়কালের সাথে সাথে ফেরত দেওয়া মাত্রা এবং মেট্রিক্স নির্দিষ্ট করে। | অ্যাপ্লিকেশন সময়সূচী রিপোর্টিং কাজ. প্রতিটি কাজের জন্য, YouTube প্রতিদিনের প্রতিবেদন তৈরি করে যা অ্যাসিঙ্ক্রোনাসভাবে ডাউনলোড করা যায়। |
| তারিখ পরিসীমা | কিছু API রিপোর্ট ব্যবহারকারীর কার্যকলাপের তারিখ নির্দিষ্ট করে। এই রিপোর্টগুলির মধ্যে কয়েকটি মাস অনুসারে ব্যবহারকারীর কার্যকলাপের মেট্রিক্সকে একত্রিত করতে মাত্রা সমর্থন করে। | সমস্ত API রিপোর্ট ব্যবহারকারীর কার্যকলাপ যে দিন ঘটেছে তা নির্দিষ্ট করে। API ব্যবহার করে অ্যাপ্লিকেশনগুলি পর্যায়ক্রমিক ব্যবধানের জন্য ডেটা একত্রিত করতে বৈশিষ্ট্যগুলি প্রয়োগ করতে পারে। |
| ফিল্টারিং ডেটা | আপনি শুধুমাত্র সারিগুলি অন্তর্ভুক্ত করতে প্রতিবেদনগুলি ফিল্টার করতে পারেন যার জন্য একটি মাত্রার একটি নির্দিষ্ট মান রয়েছে৷ এপিআই কিছু মাত্রা সমর্থন করে, যেমন মহাদেশ এবং উপমহাদেশ , যেগুলি শুধুমাত্র ফিল্টার হিসাবে ব্যবহৃত হয়। | API সম্পূর্ণ ডেটা সেটের বাল্ক ডাউনলোড সমর্থন করে। এটি ফিল্টারিং বা ফিল্টার-শুধুমাত্র মাত্রার জন্য ডেটা ফেরত সমর্থন করে না। ক্লায়েন্ট অ্যাপ্লিকেশন ডাউনলোড করা ডেটা সংরক্ষণ করে এবং ডেটা ফিল্টার করার জন্য নিজস্ব বৈশিষ্ট্যগুলি প্রয়োগ করে। |
| বাছাই | প্রত্যাবর্তিত মেট্রিক মানের উপর ভিত্তি করে প্রতিবেদনগুলি সাজানো যেতে পারে। কিছু রিপোর্ট শুধুমাত্র সীমিত সংখ্যক ফলাফল সমর্থন করে। উদাহরণ স্বরূপ, একটি চ্যানেলের সর্বাধিক দেখা ভিডিওগুলির তালিকা যে প্রতিবেদনটি সর্বাধিক 200টি সারি প্রদান করে৷ | এই API সম্পূর্ণ ডেটা সেটের বাল্ক ডাউনলোড সমর্থন করে। ক্লায়েন্ট অ্যাপ্লিকেশনগুলি ডাউনলোড করা ডেটা সাজানোর জন্য তাদের নিজস্ব বৈশিষ্ট্যগুলি প্রয়োগ করতে পারে। |
| গণনা | এপিআই রিপোর্টে টেক্সট মান থাকে, যেমন "ANDROID" বা "CHANNEL," গণিত মাত্রার মান সনাক্ত করতে। | API রিপোর্টে পূর্ণসংখ্যা রয়েছে যা পাঠ্য মানগুলিতে ম্যাপ করা যেতে পারে। |
| কোটা | এপিআই সার্ভার প্রতিটি প্রশ্নের মূল্যায়ন করে তার কোটা খরচ নির্ধারণ করে। কোটা ব্যবহারের বিভাগটি আরও বিস্তারিতভাবে পদ্ধতির ব্যাখ্যা করে। | কোটা ব্যবহার একটি সমস্যা নয় কারণ ডেটা একবার পুনরুদ্ধার করা হয় এবং তারপর ফিল্টার, সাজানো এবং অ্যাপ্লিকেশনের মধ্যে জিজ্ঞাসা করা হয়। |
| অনন্য প্রতিবেদন |
| |
| অনন্য মাত্রা | গ্রুপ (শুধুমাত্র ফিল্টার মাত্রা) মহাদেশ (শুধুমাত্র ফিল্টার মাত্রা) উপমহাদেশ (শুধুমাত্র ফিল্টার মাত্রা) মাস viewsPerPlaylistStart গড় টাইমইন প্লেলিস্ট | টীকা_আইডি টীকা_টাইপ asset_id কার্ড_আইডি কার্ড_টাইপ লাইভ_বা_অন_ডিমান্ড subscribed_status সাবটাইটেল_ভাষা |
| অনন্য মেট্রিক্স | অনন্য আপেক্ষিক ধরে রাখার কর্মক্ষমতা viewsPerPlaylistStart গড় টাইমইন প্লেলিস্ট | কার্ড_ক্লিক_রেট কার্ড_ক্লিক কার্ড_ইম্প্রেশন কার্ড_টিজার_ক্লিক_রেট কার্ড_টিজার_ক্লিক কার্ড_টিজার_ইম্প্রেশন আনুমানিক_পার্টনার_এডসেন্স_আয় আনুমানিক_পার্টনার_ডাবলক্লিক_আয়ের প্লেলিস্ট_সংরক্ষণ_যোগ করা হয়েছে প্লেলিস্ট_সংরক্ষণ_সরানো হয়েছে |
API-এর মধ্যে নামকরণের পার্থক্য
দুটি এপিআই মাত্রা এবং মেট্রিক্স সনাক্ত করতে বিভিন্ন নামকরণের নিয়ম ব্যবহার করে। YouTube অ্যানালিটিক্স API নামগুলি adType মতো CamelCase ব্যবহার করে। YouTube রিপোর্টিং API নামগুলি ছোট হাতের অক্ষরে এবং আন্ডারস্কোর ব্যবহার করে, যেমন ad_type ।
নিম্নলিখিত সারণীগুলি বিভিন্ন নাম সনাক্ত করে যা দুটি API একই মেট্রিক্স এবং মাত্রা সনাক্ত করতে ব্যবহার করে। কিছু ক্ষেত্রে, দুটি নামের মধ্যে পার্থক্য আপনি ক্যামেলকেস থেকে আন্ডারস্কোরে একটি নাম রূপান্তর করার পরে যা পাবেন তার চেয়ে বেশি। উদাহরণস্বরূপ, YouTube এনালিটিক্স এপিআই-এর video ডাইমেনশনটিকে YouTube রিপোর্টিং এপিআই-এ video_id নাম দেওয়া হয়েছে।