পুনর্বিবেচনার ইতিহাস

এই পৃষ্ঠায় YouTube Reporting API ও YouTube Analytics API, দুটির জন্যই API পরিবর্তন ও ডকুমেন্টেশন আপডেট তালিকাভুক্ত করা আছে। দুটি API-ই ডেভেলপারদের YouTube Analytics ডেটা অ্যাক্সেস করার সুবিধা দেয়, যদিও তা বিভিন্ন উপায়ে করা হয়।

৪ নভেম্বর, ২০২৬

১৫ জানুয়ারি, ২০২৭ থেকে কন্টেন্ট মালিকদের জন্য সাপ্তাহিক রেফারেন্স রিপোর্টের (content_owner_active_references_a1) ভার্সন 1.0 বন্ধ করে দেওয়া হয়েছে এবং এর পরিবর্তে ভার্সন 1.1 (content_owner_active_references_a2) ব্যবহার করা হচ্ছে। ১৫ জানুয়ারি, ২০২৭-এর আগে লেটেস্ট ভার্সনে মাইগ্রেট করতে ভুলবেন না।

৩০ অক্টোবর, ২০২৬

YouTube Reporting API এখন কন্টেন্টের মালিকদের জন্য নিম্নলিখিত সিস্টেম-ম্যানেজড রিপোর্ট সাপোর্ট করে:

বিভাগ রিপোর্টের নাম রিপোর্টের ধরন সংক্রান্ত আইডি
ফাইন্যান্সিয়াল সামারি চ্যানেল অ্যাডজাস্টমেন্টের মাসিক বিবরণ content_owner_channel_adjustments_summary_a1
ফাইন্যান্সিয়াল সামারি পেড ফিচার ট্রানজ্যাকশন থেকে মাসিক উপার্জন content_owner_transactions_paid_features_revenue_a1
ফাইন্যান্সিয়াল সামারি দেশ অনুযায়ী টাইটেল ভিত্তিক মাসিক TVOD ট্রানজ্যাকশন থেকে হওয়া উপার্জন tvod_content_owner_country_title_tvod_revenue_a1
ফাইন্যান্সিয়াল সামারি দেশ অনুযায়ী TVOD ট্রানজ্যাকশন থেকে মাসিক উপার্জন tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts মাসিক মিউজিক লেবেল Shorts অ্যাসেট ক্রিয়েশন music_content_owner_shorts_asset_creations_a1
Shorts মাসিক মিউজিক লেবেল Shorts অ্যাসেট ভিউ music_content_owner_shorts_asset_views_a1
Shorts মাসিক মিউজিক প্রকাশক Shorts অ্যাসেট তৈরি publisher_content_owner_shorts_asset_creations_a1
Shorts মাসিক মিউজিক প্রকাশক Shorts অ্যাসেট ভিউ publisher_content_owner_shorts_asset_views_a1
ট্যাক্স মাসিক MCN অ্যাফিলিয়েট ট্যাক্স রিফান্ডের বিবরণ সংক্রান্ত রিপোর্ট content_owner_affiliate_tax_refund_summary_a1
অ্যাসেট সাপ্তাহিক SRMF রিপোর্ট publisher_content_owner_weekly_srmf
অ্যাসেট দৈনিক OAC অনুরোধের স্ট্যাটাস রিপোর্ট content_owner_oac_request_status_a1
অ্যাসেট দৈনিক OAC অনুরোধের কোয়ালিটি রিপোর্ট content_owner_oac_quality_status_a1

সেপ্টেম্বর 13, 2026

YouTube Reporting API এখন কন্টেন্টের মালিকদের (content_owner_active_references_a2) জন্য সাপ্তাহিক রেফারেন্স রিপোর্টের ভার্সন ১.১-এ কাজ করে।

ভার্সন ১.১-এ নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • status_detail ফিল্ড যোগ করে, যা রেফারেন্স ফাইলের স্ট্যাটাস সম্পর্কে অতিরিক্ত বিবরণ বা কারণ প্রদান করে।
  • পার্টনার কোডের পরিবর্তে কন্টেন্টের মালিকের যে নাম দেখানো হবে সেটি বা এক্সটার্নাল আইডি ব্যবহার করার জন্য asset_owners ফিল্ড আপডেট করে।

রিপোর্টের আগের ভার্সন, ভার্সন 1.0 (content_owner_active_references_a1), এখনও উপলভ্য আছে।

সেপ্টেম্বর 9, 2026

YouTube Analytics API এবং YouTube Reporting API ডকুমেন্টেশন নিম্নলিখিত সংযোজন এবং স্পষ্টীকরণের সাথে আপডেট করা হয়েছে:

  • ডেটা ফ্রেশনেস ও লেটেন্সি SLA: ডেটা মডেলে একটি নির্দিষ্ট বিভাগ যোগ করা হয়েছে যেখানে ৪৮ থেকে ৭২ ঘণ্টার ডেটা প্রসেসিং সংক্রান্ত বিলম্ব, শেষ সম্পূর্ণ প্রসেস করা দিনের এন্ড-ডেট ট্রাঙ্কেশন এবং রিয়েল-টাইম ভিডিও স্ট্যাটিস্টিক্সের জন্য YouTube Data API videos.list পদ্ধতি সাজেস্ট করা হয়েছে।

  • চ্যানেল রিপোর্টে মনিটারি মেট্রিক: চ্যানেল রিপোর্ট অনুমোদনের ডকুমেন্টেশন আপডেট করা হয়েছে যাতে স্পষ্ট করে বোঝানো যায় যে চ্যানেলটি YouTube পার্টনার প্রোগ্রাম (YPP)-এর মেম্বার হলে, https://www.googleapis.com/auth/yt-analytics-monetary.readonly স্কোপের মাধ্যমে অনুমোদিত চ্যানেল রিপোর্টের জন্য আনুমানিক উপার্জন এবং বিজ্ঞাপন পারফর্ম্যান্স মেট্রিক কাজ করে এবং মনিটাইজ না করা চ্যানেল HTTP 403 Forbidden রিটার্ন করে।

  • কোয়েরি সংক্রান্ত সীমাবদ্ধতা ও প্যারামিটার কম্প্যাটিবিলিটি: রিপোর্ট টেবিল বোঝা নিবন্ধে একটি পরামর্শমূলক নোট যোগ করা হয়েছে, যেখানে স্পষ্ট করা হয়েছে যে ভুল বা পারস্পরিকভাবে এক্সক্লুসিভ ডাইমেনশন, মেট্রিক ও ফিল্টার কম্বিনেশন HTTP 400 badRequest ("The query is not supported.") রিটার্ন করে।

  • বাল্ক রিপোর্টে খালি ডাইমেনশন ভ্যালু: YouTube Reporting API রিপোর্টের বৈশিষ্ট্য আপডেট করা হয়েছে যাতে ব্যাখ্যা করা যায় যে video_id বা channel_id-এর মতো ডাইমেনশন কলামে খালি স্ট্রিং থাকে যাতে মুছে ফেলা রিসোর্সের জন্য মোট মেট্রিক গণনা সংরক্ষণ করা যায় এবং চ্যানেল-লেভেল ইভেন্ট দেখানো যায়।

২৭ আগস্ট, ২০২৬

YouTube সব ভিডিও ফর্ম্যাটের জন্য পাবলিক ভিউ কাউন্ট করার পদ্ধতি একই রকম করবে: বড় দৈর্ঘ্যের ভিডিও, লাইভ ও Shorts। ভিডিও চালানো শুরু করার মুহূর্ত থেকেই YouTube পাবলিক ভিউ গণনা করবে।

মনিটাইজেশনের যোগ্যতা এবং বেশিরভাগ মূল পারফর্ম্যান্স মেট্রিক প্রভাবিত হয় না কারণ সেগুলি এনগেজড মেট্রিকের উপর নির্ভর করে। ক্রিয়েটরের উপার্জন "এনগেজড Shorts ভিউ" এবং "এনগেজড দেখার মোট সময়" অনুযায়ী গণনা করা হবে, যা আপনি YouTube Analytics > উন্নত মোড থেকে দেখতে পাবেন।

YouTube পার্টনার প্রোগ্রামের যোগ্যতায় কোনও পরিবর্তন করা হয়নি। YouTube পার্টনার প্রোগ্রামে যোগ দেওয়ার প্রয়োজনীয়তা এখন "উপযুক্ত Shorts ভিউ" এবং "উপযুক্ত ওয়াচ টাইম" (আগে "সর্বজনীন Shorts-এ পাওয়া ভিউ" এবং "সর্বজনীনভাবে দেখার মোট সময়") হিসেবে উল্লেখ করা হবে।

আরও জানতে, আপনার YouTube কন্টেন্টের পারফর্ম্যান্স বুঝুন নিবন্ধটি দেখুন।

মেট্রিক স্ট্যাটাস Trigger এর জন্য ব্যবহার করা হয়েছে
ভিউ আপডেট করা হয়েছে ভিডিও প্রথম ফ্রেম থেকে চালানো হয় (এর মধ্যে অটোপ্লে, পয়েন্টার ধরে রাখা এবং চালানোর জন্য ক্লিক/ট্যাপ করা অন্তর্ভুক্ত)। স্ট্যান্ডার্ড সর্বজনীন ভিউয়ের সংখ্যা।
এনগেজড ভিউ অপরিবর্তিত রয়েছে প্রথম ফ্রেমের পরেও প্লেব্যাক চলতে থাকে অথবা ব্যবহারকারী চালানোর জন্য ক্লিক/ট্যাপ করেন। YouTube পার্টনার প্রোগ্রামের মাধ্যমে মনিটাইজেশন, বেশিরভাগ মূল অ্যানালিটিক্স (ক্লিক-থ্রু রেট, দেখার গড় সময়সীমা) এবং এনগেজড রিপোর্টিং।
থাম্বনেল ইম্প্রেশন অপরিবর্তিত রয়েছে ইন্টার‍্যাকশন বা অটোপ্লে ছাড়াই থাম্বনেল দেখানো হয়। ফিড-লেভেল এক্সপোজার ও প্যাকেজিং পরিমাপ করে।

API ডকুমেন্টেশন আপডেট: YouTube Analytics API মেট্রিক এবং YouTube Reporting API মেট্রিক ডকুমেন্টেশনে engagedViews মেট্রিকের সংজ্ঞা আপডেট করা হয়েছে।

২৫ জুন, ২০২৬

কন্টেন্ট মালিকদের জন্য শহর অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি রিপোর্ট সরিয়ে দেওয়ার জন্য YouTube Analytics API (টার্গেট করা কোয়েরি) ডকুমেন্টেশন আপডেট করা হয়েছে। কন্টেন্টের মালিকদের জন্য এই রিপোর্ট কাজ করে না; শহর অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি সম্পর্কে কন্টেন্টের মালিকের কোয়েরি কোনও ফলাফল দেখাবে না।

৯ মার্চ, ২০২৬

ageGroup (YouTube Analytics API) এবং age_group (YouTube Reporting API) ডাইমেনশনে এখন সেইসব ব্যবহারকারী অন্তর্ভুক্ত আছেন যাদের বয়স YouTube-এর অনুমান অনুযায়ী ১৮ বছরের কম।

১৫ জানুয়ারি, ২০২৬

YouTube Reporting API এখন চ্যানেল ও কন্টেন্টের মালিকদের জন্য রিচ রিপোর্ট সাপোর্ট করে। রিচ রিপোর্ট থেকে ভিডিও থাম্বনেল ইম্প্রেশন ও ক্লিক-থ্রু রেটের পরিসংখ্যান পাওয়া যায়।

  • চ্যানেলের জন্য channel_reach_basic_a1 ও channel_reach_combined_a1 রিপোর্ট উপলভ্য।
  • কন্টেন্টের মালিকদের জন্য content_owner_reach_basic_a1 এবং content_owner_reach_combined_a1 রিপোর্ট উপলভ্য।

এইসব রিপোর্টে নিম্নলিখিত নতুন মেট্রিক কাজ করে:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

২২ সেপ্টেম্বর, ২০২৫

রিপোর্ট বন্ধ করার যে আগে ঘোষণা করা হয়েছিল, তা ৩০ সেপ্টেম্বর, ২০২৫ থেকে পিছিয়ে ৩১ অক্টোবর, ২০২৫ করা হয়েছে। Shorts-এর ভিউ গণনা সংক্রান্ত পরিবর্তনের জন্য আপডেট করা রিপোর্টের আগের ভার্সনগুলি সেই সময় পর্যন্ত উপলভ্য থাকবে, তবে দাবি সংক্রান্ত রিপোর্ট v1.0 (content_owner_active_claims_a1) এবং দাবি সংক্রান্ত রিপোর্ট v1.1 (content_owner_active_claims_a2) এর ব্যতিক্রম, যা ৩০ সেপ্টেম্বর থেকে আর উপলভ্য থাকবে না।

২৪ জুন, ২০২৫

২৬ মার্চ, ২০২৫-এ ঘোষণা করা হয়েছে যে, নতুন Shorts ভিউকাউন্ট পরিবর্তনের অংশ হিসেবে বাল্ক রিপোর্ট API আপডেট করা হবে। নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • ভিউ অন্তর্ভুক্ত আছে এমন প্রতিটি রিপোর্টের জন্য নতুন রিপোর্ট ভার্সন তৈরি করা হয়েছে, যা বেশিরভাগ রিপোর্টের ক্ষেত্রেই প্রযোজ্য। প্রভাবিত প্রতিটি রিপোর্টের ভার্সন এক করে বৃদ্ধি পেয়েছে, যেমন ভার্সন a2 থেকে ভার্সন a3।
  • Shorts-এর ক্ষেত্রে, Shorts চালানো শুরু করা বা রিপ্লে করার সংখ্যাকে এখন ভিউ হিসেবে গণনা করা হবে। ভিডিওর ক্ষেত্রে কোনও পরিবর্তন হয়নি।
  • আপডেট করা রিপোর্টে একটি নতুন কলাম, engaged_views, অন্তর্ভুক্ত থাকবে, যা আগের ভিউ-গণনার পদ্ধতিকে প্রতিফলিত করবে।

এই পরিবর্তনগুলি ৩০ জুন, ২০২৫ থেকে বাল্ক রিপোর্ট API-এর জন্য কার্যকর হবে। সেই অনুযায়ী আপনার রিপোর্ট প্রসেস করার বিষয়টি অ্যাডজাস্ট করতে ভুলবেন না।

রিপোর্টের আগের ভার্সন ৩০ সেপ্টেম্বর, ২০২৫ পর্যন্ত উপলভ্য থাকবে। ৩০ সেপ্টেম্বর, ২০২৫-এর পরে, আগের ভার্সনগুলি বন্ধ করে দেওয়া হবে। লেটেস্ট ভার্সনে মাইগ্রেট করতে ভুলবেন না।

সবশেষে, রিপোর্ট প্রসেস করার সময় পেশাদার পদ্ধতি অনুসরণ করতে ভুলবেন না, যাতে ভবিষ্যতে রিপোর্টে কোনও পরিবর্তন হলে আপনার প্রসেসিং পাইপলাইন ভেঙে না যায়।

নিচের সারণীতে প্রতিটি রিপোর্টের ধরনের জন্য নতুন রিপোর্টের ভার্সন দেখানো হয়েছে:

YouTube Analytics-এর জন্য বাল্ক ডেটা রিপোর্ট

চ্যানেল রিপোর্ট - ভিডিও রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
ব্যবহারকারীর অ্যাক্টিভিটি channel_basic_a2 channel_basic_a3
প্রদেশ অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি channel_province_a2 channel_province_a3
প্লেব্যাক লোকেশন channel_playback_location_a2 channel_playback_location_a3
ট্রাফিকের উৎস channel_traffic_source_a2 channel_traffic_source_a3
ডিভাইসের ধরন ও অপারেটিং সিস্টেম channel_device_os_a2 channel_device_os_a3
সাবটাইটেল channel_subtitles_a2 channel_subtitles_a3
কম্বাইন্ড channel_combined_a2 channel_combined_a3
চ্যানেল রিপোর্ট - প্লেলিস্ট রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
ব্যবহারকারীর অ্যাক্টিভিটি playlist_basic_a1 playlist_basic_a2
প্রদেশ অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি playlist_province_a1 playlist_province_a2
প্লেব্যাক লোকেশন playlist_playback_location_a1 playlist_playback_location_a2
ট্রাফিকের উৎস playlist_traffic_source_a1 playlist_traffic_source_a2
ডিভাইসের ধরন ও অপারেটিং সিস্টেম playlist_device_os_a1 playlist_device_os_a2
কম্বাইন্ড playlist_combined_a1 playlist_combined_a2
কন্টেন্টের মালিকের রিপোর্ট - ভিডিও রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
ব্যবহারকারীর অ্যাক্টিভিটি content_owner_basic_a3 content_owner_basic_a4
প্রদেশ অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি content_owner_province_a2 content_owner_province_a3
প্লেব্যাক লোকেশন content_owner_playback_location_a2 content_owner_playback_location_a3
ট্রাফিকের উৎস content_owner_traffic_source_a2 content_owner_traffic_source_a3
ডিভাইসের ধরন ও অপারেটিং সিস্টেম content_owner_device_os_a2 content_owner_device_os_a3
সাবটাইটেল content_owner_subtitles_a2 content_owner_subtitles_a3
কম্বাইন্ড content_owner_combined_a2 content_owner_combined_a3
কন্টেন্টের মালিকের রিপোর্ট - প্লেলিস্ট রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
ব্যবহারকারীর অ্যাক্টিভিটি content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
প্রদেশ অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি content_owner_playlist_province_a1 content_owner_playlist_province_a2
প্লেব্যাক লোকেশন content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
ট্রাফিকের উৎস content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
ডিভাইসের ধরন ও অপারেটিং সিস্টেম content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
কম্বাইন্ড content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
কন্টেন্টের মালিকের রিপোর্ট - অ্যাসেট রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
ব্যবহারকারীর অ্যাক্টিভিটি content_owner_asset_basic_a2 content_owner_asset_basic_a3
প্রদেশ অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি content_owner_asset_province_a2 content_owner_asset_province_a3
ভিডিও প্লেব্যাক লোকেশন content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
ট্রাফিকের উৎস content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
ডিভাইসের ধরন ও অপারেটিং সিস্টেম content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
কম্বাইন্ড content_owner_asset_combined_a2 content_owner_asset_combined_a3

সিস্টেম-ম্যানেজড রিপোর্ট - ফাইন্যান্সিয়াল (নন-মিউজিক)

কন্টেন্টের মালিকের রিপোর্ট - Shorts রিপোর্ট (মিউজিক নয়)
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
বিজ্ঞাপন থেকে হওয়া মোট উপার্জনের সারাংশ content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
বিজ্ঞাপন থেকে দৈনিক উপার্জনের সারাংশ content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
দেশ অনুযায়ী বিজ্ঞাপন থেকে উপার্জনের সারাংশ content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
বিজ্ঞাপন থেকে উপার্জনের সারাংশ content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

সিস্টেম-ম্যানেজড রিপোর্ট - নন-ফাইন্যান্সিয়াল

কন্টেন্টের মালিকের রিপোর্ট - দাবির রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
সক্রিয় দাবি content_owner_active_claims_a2 content_owner_active_claims_a3
কন্টেন্টের মালিকের রিপোর্ট - ভিডিও মেটাডেটা রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
ভিডিও মেটাডাটা content_owner_video_metadata_a3 content_owner_video_metadata_a4
কন্টেন্টের মালিকের রিপোর্ট - অ্যাসেট রিপোর্ট
রিপোর্টের নাম আগের ভার্সন লেটেস্ট ভার্সন
অ্যাসেট content_owner_asset_a2 content_owner_asset_a3
অ্যাসেট সংক্রান্ত বিবাদ content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

২৪ এপ্রিল, ২০২৫

২৬ মার্চ, ২০২৫-এ ঘোষণা করা হয়েছে যে, Shorts-এর ভিউ গণনার পদ্ধতিতে নতুন পরিবর্তনের অংশ হিসেবে, Targeted Queries API আপডেট করা হবে:

  • Shorts-এর ক্ষেত্রে, views এখন Short কতবার চালানো বা রিপ্লে করা হয়েছে তা গণনা করবে।
  • একটি নতুন মেট্রিক, engagedViews, আগের ভিউ-গণনার পদ্ধতিকে প্রতিফলিত করবে। engagedViews, views-এর সাথে সব রিপোর্টে উপলভ্য হবে।

টার্গেট করা কোয়েরি API-এর জন্য এই পরিবর্তন ৩০ এপ্রিল, ২০২৫ থেকে কার্যকর হবে। সেই অনুযায়ী আপনার কোয়েরি অ্যাডজাস্ট করতে ভুলবেন না।

বাল্ক রিপোর্ট API-তে কী কী পরিবর্তন এবং কখন করা হবে তা জানতে এই রিভিশন ইতিহাস চেক করুন।

২২ এপ্রিল, ২০২৫

৭ এপ্রিল, ২০২৪-এ ঘোষণা করা হয়েছে যে, চ্যানেল রিপোর্ট ও কন্টেন্টের মালিকের প্লেলিস্ট রিপোর্টের জন্য isCurated ডাইমেনশন বন্ধ করে দেওয়া হয়েছে। ৩১ ডিসেম্বর, ২০২৪ থেকে এই ডাইমেনশন আর কাজ করে না। রিপোর্ট ও ডকুমেন্টেশন থেকে ডাইমেনশন সরিয়ে দেওয়া হয়েছে।

২৬ মার্চ, ২০২৫

এই আপডেটে YouTube Analytics ও Reporting API সম্পর্কিত নিম্নলিখিত পরিবর্তন করা হয়েছে:

৩১ মার্চ, ২০২৫ থেকে, YouTube Shorts-এর ভিউ গণনার পদ্ধতি পরিবর্তন করবে। আগে, Shorts-এর ক্ষেত্রে, একটি Short নির্দিষ্ট সংখ্যক সেকেন্ডের জন্য চালানোর পরে একটি ভিউ গণনা করা হত। এখন, আপনার Short কতবার চালানো বা রিপ্লে করা হয়েছে তার উপর ভিত্তি করে ভিউ গণনা করা হবে, এক্ষেত্রে ন্যূনতম দেখার সময় আর জরুরি নয়। আরও জানুন

YouTube Analytics (টার্গেট করা কোয়েরি) এবং Reporting (বাল্ক রিপোর্ট) API-তে নিম্নলিখিত পরিবর্তন করা হবে:

  • Shorts-এর ক্ষেত্রে, views কোনও Short কতবার চালানো বা রিপ্লে করা হয়েছে তা গণনা করে।
  • একটি নতুন মেট্রিক, engagedViews, উপলভ্য করা হবে এবং এটি আগের ভিউ-গণনার পদ্ধতিকে প্রতিফলিত করবে।
  • আপনি কোনও চ্যানেলের মালিক হলে বা কোনও চ্যানেলের ডেটা অ্যাক্সেস করার জন্য অনুমোদিত হলে, আপনি আপডেট করা ভিউ এবং এনগেজড ভিউ, দুটিরই কোয়েরি করতে পারবেন।

টার্গেট করা কোয়েরি ৩০ এপ্রিলের মধ্যে এবং বাল্ক রিপোর্ট ৩০ জুনের মধ্যে আপডেট করা হবে। সেই সময় পর্যন্ত, পুরনো পদ্ধতি অনুযায়ী ভিউ গণনা করা হবে। Shorts ও চ্যানেল ভিউ Studio-র Analytics-এর সাথে মিলবে না।

এছাড়াও, দৈনিক দাবির (ভার্সন 1.0) রিপোর্টের আগে-ঘোষিত বন্ধ হয়ে যাওয়া পিছিয়ে দেওয়া হয়েছে।

API-তে কখন পরিবর্তন করা হয়েছে তা জানতে এই রিভিশন ইতিহাস চেক করুন।

৩ মার্চ, ২০২৫

এই আপডেটে YouTube Reporting API সম্পর্কিত নিম্নলিখিত পরিবর্তন অন্তর্ভুক্ত আছে:

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

পার্টনারদের জন্য দৈনিক দাবি (ভার্সন 1.0) রিপোর্ট বন্ধ করে দেওয়া হয়েছে। ৩০ এপ্রিল, ২০২৫ থেকে বা তার পরে এটি আর কাজ করবে না। সেই অনুযায়ী রিপোর্টের সংজ্ঞা আপডেট করা হয়েছে। পরিবর্তে লেটেস্ট দৈনিক দাবির রিপোর্ট ব্যবহার করুন।

১৫ নভেম্বর, ২০২৪

মনে রাখবেন: নিম্নলিখিত পরিবর্তন ১৮ নভেম্বর, ২০২৪ থেকে কার্যকর হবে।

YouTube Analytics (টার্গেট করা কোয়েরি) API ডকুমেন্টেশন আপডেট করা হয়েছে এবং তাতে উল্লেখ করা হয়েছে যে ট্রাফিক সোর্স রিপোর্টের জন্য, API-এর reports.query পদ্ধতি এখন একটি ত্রুটি দেখায় যদি কোয়েরি করা ভিডিওর সংখ্যা X তারিখের রেঞ্জে দিনের সংখ্যা-এর গুণফল ৫০,০০০-এর বেশি হয়। যেমন, ৫০০টি ভিডিও আইডির ডেটা রিট্রিভ করে এমন কোয়েরি সর্বাধিক ১০০ দিনের ডেটার জন্য অনুরোধ করতে পারে।

এই পরিবর্তন চ্যানেল এবং কন্টেন্টের মালিক, উভয়ের রিপোর্টের উপর প্রভাব ফেলে।

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

৬ মে, ২০২৪

YouTube Analytics (টার্গেট করা কোয়েরি) API চ্যানেলের জন্য তিনটি নতুন রিপোর্ট প্রদান করে:

  • DMA অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি রিপোর্ট হল একটি ভৌগোলিক রিপোর্ট যা নির্ধারিত মার্কেট অঞ্চল (DMA) অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটির পরিসংখ্যান প্রদান করে। এই রিপোর্টের জন্য, আপনাকে filters প্যারামিটারের মান country==US-এ সেট করতে হবে।

  • একসাথে দেখা দর্শক রিপোর্ট থেকে একটি লাইভ স্ট্রিম করা ভিডিওর বিভিন্ন অংশে একসাথে দেখা দর্শকের সংখ্যা জানা যায়।

  • মেম্বারশিপ বাতিল করা রিপোর্ট থেকে ব্যবহারকারীরা কেন তাদের চ্যানেল মেম্বারশিপ বাতিল করেছেন সেই সংক্রান্ত পরিসংখ্যান পাওয়া যায়।

    এই রিপোর্টে নতুন membershipsCancellationSurveyReason ডাইমেনশন ব্যবহার করা হয়, যা কোনও ব্যবহারকারী কেন চ্যানেল মেম্বারশিপ বাতিল করেছেন তা নির্দিষ্ট করে। এছাড়াও, এটি নতুন membershipsCancellationSurveyResponses মেট্রিক ব্যবহার করে, যা দেখায় যে সেই কারণে কতগুলি চ্যানেল মেম্বারশিপ বাতিল করা হয়েছে।

এছাড়াও, তিনটি নতুন মেট্রিককে সাপোর্ট করার জন্য দর্শক ধরে রাখা সংক্রান্ত রিপোর্ট উন্নত করা হয়েছে:

৭ এপ্রিল, ২০২৪

YouTube Analytics (টার্গেট করা কোয়েরি) API-তে কন্টেন্টের মালিকের প্লেলিস্ট রিপোর্টের সাথে সম্পর্কিত একাধিক আপডেট করা হয়েছে। এই আপডেটগুলি চ্যানেল প্লেলিস্ট রিপোর্টের সাথে সম্পর্কিত আপডেটের মতোই, যা ১৯ জানুয়ারি, ২০২৪-এ ঘোষণা করা হয়েছিল।

নিচের রিভিশন ইতিহাসের এন্ট্রি ১৯ জানুয়ারি, ২০২৪-এর এন্ট্রির মতোই প্রায় একই তথ্য প্রদান করে। তবে মনে রাখবেন, কন্টেন্টের মালিকের প্লেলিস্ট রিপোর্টে isCurated ডাইমেনশন ৩১ ডিসেম্বর, ২০২৪ পর্যন্ত কাজ করবে, অন্যদিকে চ্যানেল প্লেলিস্ট রিপোর্টের ক্ষেত্রে ডাইমেনশনটি ৩০ জুন, ২০২৪ পর্যন্ত কাজ করবে।

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    কন্টেন্টের মালিকের প্লেলিস্ট রিপোর্টের জন্য isCurated ডাইমেনশন বন্ধ করা হয়েছে। ৩১ ডিসেম্বর, ২০২৪ বা তার পরে এটি আর কাজ করবে না। সেই অনুযায়ী ডাইমেনশনের সংজ্ঞা আপডেট করা হয়েছে।

    isCurated ডাইমেনশন সরিয়ে দেওয়ার পরেও ব্যাকওয়ার্ড কম্প্যাটিবিলিটি বজায় রাখতে, আপনাকে কোড আপডেট করতে হবে যাতে শুধুমাত্র প্লেলিস্ট রিপোর্টের জন্য views মেট্রিকের পরিবর্তে playlistViews মেট্রিক পাওয়া যায়। যেহেতু views মেট্রিক এখনও প্লেলিস্ট রিপোর্টের জন্য কাজ করে, যদিও এর অর্থ আলাদা, তাই আপনি মেট্রিকের নাম আপডেট না করলেও API ডেটা রিটার্ন করবে। অবশ্যই, আপনি views এবং playlistViews দুটিই পুনরুদ্ধার এবং প্রদর্শন করতে আপনার অ্যাপ্লিকেশন পরিবর্তন করতে পারেন।

    isCurated ডাইমেনশন ছাড়াও, নিম্নলিখিত API কার্যকারিতা নতুন রিপোর্টে আর কাজ করে না:

    • নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য লোকেশন ফিল্টার, যেমন continent এবং subcontinent কাজ করে না।
    • নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য redViews এবং estimatedRedMinutesWatched মেট্রিক আর কাজ করে না। এইসব মেট্রিক YouTube Studio-তে উপলভ্য নেই, তাই এই পরিবর্তন API-এর কার্যকারিতাকে Studio অ্যাপ্লিকেশনে উপলভ্য কার্যকারিতার সাথে সামঞ্জস্যপূর্ণ করে তোলে।
    • চ্যানেল প্লেলিস্ট রিপোর্টের ফিল্টার হিসেবে subscribedStatus এবং youtubeProduct ডাইমেনশন আর কাজ করে না। এইসব ফিল্টার YouTube Studio-তে উপলভ্য ছিল না, তাই এই পরিবর্তন API-এর কার্যকারিতাকে Studio অ্যাপ্লিকেশনে উপলভ্য কার্যকারিতার সাথে সামঞ্জস্যপূর্ণ করে তোলে।

  • কন্টেন্টের মালিকের রিপোর্ট সংক্রান্ত ডকুমেন্টেশনের প্লেলিস্ট রিপোর্ট বিভাগটি আপডেট করা হয়েছে যাতে প্লেলিস্ট রিপোর্টের জন্য কাজ করে এমন মেট্রিক্সের ধরনগুলি আরও পুঙ্খানুপুঙ্খভাবে ব্যাখ্যা করা যায়:

    • এগ্রিগেট করা ভিডিও মেট্রিক ব্যবহারকারীর অ্যাক্টিভিটি ও ইম্প্রেশন মেট্রিক প্রদান করে যা কন্টেন্টের মালিকের প্লেলিস্টে থাকা সব ভিডিওর জন্য এগ্রিগেট করা হয় এবং সেইসব ভিডিওর মালিকও কন্টেন্টের মালিক। এগ্রিগেট করা ভিডিও মেট্রিক শুধুমাত্র সেইসব API অনুরোধের ক্ষেত্রে কাজ করে যেগুলি isCurated ডাইমেনশন ব্যবহার করে না।
    • প্লেলিস্ট-মধ্যস্থ মেট্রিক প্লেলিস্ট পৃষ্ঠার প্রসঙ্গে ব্যবহারকারীর অ্যাক্টিভিটি ও এনগেজমেন্ট দেখায়। এইসব মেট্রিকে প্লেলিস্টে থাকা আপনার মালিকানাধীন নয় এমন ভিডিওর ভিউয়ের ডেটাও অন্তর্ভুক্ত থাকবে, তবে শুধুমাত্র সেইসব ভিউয়ের ক্ষেত্রে যেগুলি প্লেলিস্টের প্রসঙ্গে ঘটেছে।
    • কাজ করে এমন প্লেলিস্ট মেট্রিক বিভাগটি প্লেলিস্ট রিপোর্টের জন্য কাজ করে এমন সামগ্রিক ভিডিও মেট্রিক এবং ইন-প্লেলিস্ট মেট্রিক শনাক্ত করে।

  • কন্টেন্টের মালিকদের জন্য প্লেলিস্ট রিপোর্টে নিম্নলিখিত নতুন প্লেলিস্ট-মধ্যস্থ মেট্রিক কাজ করে। মনে রাখবেন যে রিপোর্ট ফিরিয়ে আনার জন্য API অনুরোধে isCurated ডাইমেনশন ব্যবহার করা না হলে, তবেই এইসব মেট্রিক কাজ করে। প্রতিটি মেট্রিকের সংজ্ঞা জানতে মেট্রিক ডকুমেন্টেশন দেখুন:

  • views মেট্রিকের আচরণ এখন নির্ভর করে যে API অনুরোধ প্লেলিস্ট রিপোর্ট ফিরিয়ে এনেছে সেটি isCurated ডাইমেনশন ব্যবহার করেছে কিনা তার উপর:

    • কোনও অনুরোধে isCurated ডাইমেনশন অন্তর্ভুক্ত থাকলে, views মেট্রিক হল একটি ইন-প্লেলিস্ট মেট্রিক যা কন্টেন্টের মালিকের প্লেলিস্টের প্রসঙ্গে ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দেশ করে।
    • কোনও অনুরোধে isCurated ডাইমেনশন অন্তর্ভুক্ত না থাকলে, views মেট্রিক হল একটি সামগ্রিক ভিডিও মেট্রিক যা কন্টেন্টের মালিকের প্লেলিস্টে থাকা ভিডিওগুলি মোট কতবার দেখা হয়েছে তা নির্দিষ্ট করে, তা প্লেলিস্টের প্রসঙ্গে দেখা হয়েছে কিনা তা নির্বিশেষে। মোট ভিউয়ের মধ্যে শুধু সেইসব ভিডিওর ভিউ অন্তর্ভুক্ত থাকে যেগুলি প্লেলিস্টের মালিকানা থাকা চ্যানেলের সাথে যুক্ত কন্টেন্টের মালিকের মালিকানাধীন।

      এইসব রিপোর্টে, যেখানে isCurated ডাইমেনশন ব্যবহার করা হয় না, সেখানে playlistViews মেট্রিক থেকে বোঝা যায় যে প্লেলিস্টের প্রসঙ্গে ভিডিওটি কতবার দেখা হয়েছে। এই মেট্রিক প্লেলিস্টের সব ভিডিওর ভিউ গণনা করে, সেগুলি যে চ্যানেলেরই হোক না কেন।

  • প্রতিটি প্লেলিস্ট রিপোর্টের জন্য, কন্টেন্টের মালিকের রিপোর্ট ডকুমেন্টেশনে এখন এমন টেবিল অন্তর্ভুক্ত রয়েছে যা সেই রিপোর্টের জন্য কাজ করে এমন মেট্রিক দেখায়, API অনুরোধে isCurated ডাইমেনশন অন্তর্ভুক্ত আছে কিনা তার উপর নির্ভর করে। উদাহরণ দেখতে সময়-ভিত্তিক প্লেলিস্ট রিপোর্ট সংজ্ঞায়িত করা বিভাগটি দেখুন।

১৯ জানুয়ারি, ২০২৪

YouTube Analytics (টার্গেট করা কোয়েরি) API-তে চ্যানেল প্লেলিস্ট রিপোর্টের সাথে সম্পর্কিত বেশ কিছু আপডেট করা হয়েছে। আপডেটে একটি বাতিল করা ডাইমেনশন এবং বেশ কিছু নতুন ও আপডেট করা মেট্রিক অন্তর্ভুক্ত রয়েছে:

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    চ্যানেল রিপোর্টের জন্য isCurated ডাইমেনশন বন্ধ করে দেওয়া হয়েছে। ৩০ জুন, ২০২৪ বা তার পরে এটি আর কাজ করবে না। সেই অনুযায়ী ডাইমেনশনের সংজ্ঞা আপডেট করা হয়েছে।

    isCurated ডাইমেনশন সরিয়ে দেওয়ার পরেও ব্যাকওয়ার্ড কম্প্যাটিবিলিটি বজায় রাখতে, আপনাকে কোড আপডেট করতে হবে যাতে শুধুমাত্র প্লেলিস্ট রিপোর্টের জন্য views মেট্রিকের পরিবর্তে playlistViews মেট্রিক পাওয়া যায়। যেহেতু views মেট্রিক এখনও প্লেলিস্ট রিপোর্টের জন্য কাজ করে, যদিও এর অর্থ আলাদা, তাই আপনি মেট্রিকের নাম আপডেট না করলেও API ডেটা রিটার্ন করবে। অবশ্যই, আপনি views এবং playlistViews দুটিই পুনরুদ্ধার এবং প্রদর্শন করতে আপনার অ্যাপ্লিকেশন পরিবর্তন করতে পারেন।

    isCurated ডাইমেনশন ছাড়াও, নিম্নলিখিত API কার্যকারিতা নতুন রিপোর্টে আর কাজ করে না:

    • নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য লোকেশন ফিল্টার, যেমন continent এবং subcontinent কাজ করে না।
    • নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য redViews এবং estimatedRedMinutesWatched মেট্রিক আর কাজ করে না। এইসব মেট্রিক YouTube Studio-তে উপলভ্য নেই, তাই এই পরিবর্তন API-এর কার্যকারিতাকে Studio অ্যাপ্লিকেশনে উপলভ্য কার্যকারিতার সাথে সামঞ্জস্যপূর্ণ করে তোলে।
    • চ্যানেল প্লেলিস্ট রিপোর্টের ফিল্টার হিসেবে subscribedStatus এবং youtubeProduct ডাইমেনশন আর কাজ করে না। এইসব ফিল্টার YouTube Studio-তে উপলভ্য ছিল না, তাই এই পরিবর্তন API-এর কার্যকারিতাকে Studio অ্যাপ্লিকেশনে উপলভ্য কার্যকারিতার সাথে সামঞ্জস্যপূর্ণ করে তোলে।

  • চ্যানেল রিপোর্ট সংক্রান্ত ডকুমেন্টেশনের প্লেলিস্ট রিপোর্ট বিভাগটি আপডেট করা হয়েছে যাতে প্লেলিস্ট রিপোর্টের জন্য কাজ করে এমন মেট্রিকের ধরন আরও পুঙ্খানুপুঙ্খভাবে ব্যাখ্যা করা যায়:

    • এগ্রিগেট করা ভিডিও মেট্রিক ব্যবহারকারীর অ্যাক্টিভিটি ও ইম্প্রেশন মেট্রিক প্রদান করে যা চ্যানেলের প্লেলিস্টে থাকা সব ভিডিওর জন্য এগ্রিগেট করা হয়, যেগুলি সেই চ্যানেলের মালিকানাধীন। এগ্রিগেট করা ভিডিও মেট্রিক শুধুমাত্র সেইসব API অনুরোধের ক্ষেত্রে কাজ করে যেগুলি isCurated ডাইমেনশন ব্যবহার করে না।
    • প্লেলিস্ট-মধ্যস্থ মেট্রিক প্লেলিস্ট পৃষ্ঠার প্রসঙ্গে ব্যবহারকারীর অ্যাক্টিভিটি ও এনগেজমেন্ট দেখায়। এইসব মেট্রিকে প্লেলিস্টে থাকা আপনার মালিকানাধীন নয় এমন ভিডিওর ভিউয়ের ডেটাও অন্তর্ভুক্ত থাকবে, তবে শুধুমাত্র সেইসব ভিউয়ের ক্ষেত্রে যেগুলি প্লেলিস্টের প্রসঙ্গে ঘটেছে।
    • কাজ করে এমন প্লেলিস্ট মেট্রিক বিভাগটি প্লেলিস্ট রিপোর্টের জন্য কাজ করে এমন সামগ্রিক ভিডিও মেট্রিক এবং ইন-প্লেলিস্ট মেট্রিক শনাক্ত করে।

  • চ্যানেলের প্লেলিস্ট রিপোর্টের জন্য নিম্নলিখিত নতুন প্লেলিস্ট-মধ্যস্থ মেট্রিক কাজ করে। কন্টেন্টের মালিকের রিপোর্টের জন্য এইসব মেট্রিক এখনও কাজ করে না। মনে রাখবেন যে এই মেট্রিকগুলি শুধুমাত্র তখনই কাজ করে যদি রিপোর্টগুলি পুনরুদ্ধার করার জন্য API অনুরোধে isCurated ডাইমেনশন ব্যবহার করা না হয়। প্রতিটি মেট্রিকের সংজ্ঞা জানতে মেট্রিক ডকুমেন্টেশন দেখুন:

  • views মেট্রিকের আচরণ এখন নির্ভর করে যে API অনুরোধ প্লেলিস্ট রিপোর্ট ফিরিয়ে এনেছে সেটি isCurated ডাইমেনশন ব্যবহার করেছে কিনা তার উপর:

    • কোনও অনুরোধে isCurated ডাইমেনশন অন্তর্ভুক্ত থাকলে, views মেট্রিক হল একটি ইন-প্লেলিস্ট মেট্রিক যা চ্যানেলের প্লেলিস্টের প্রসঙ্গে ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দেশ করে।
    • কোনও অনুরোধে isCurated ডাইমেনশন অন্তর্ভুক্ত না থাকলে, views মেট্রিক হল একটি এগ্রিগেট করা ভিডিও মেট্রিক যা চ্যানেলের প্লেলিস্টে থাকা ভিডিওটি মোট কতবার দেখা হয়েছে তা নির্দিষ্ট করে, সেই ভিউগুলি প্লেলিস্টের প্রসঙ্গে হয়েছে কিনা তা নির্বিশেষে। মোট ভিউয়ের মধ্যে শুধু সেইসব ভিডিওর ভিউ অন্তর্ভুক্ত থাকে যেগুলি প্লেলিস্টের মালিকানাধীন চ্যানেলের মালিকানাধীন।

      এইসব রিপোর্টে, যেখানে isCurated ডাইমেনশন ব্যবহার করা হয় না, সেখানে playlistViews মেট্রিক থেকে বোঝা যায় যে প্লেলিস্টের প্রসঙ্গে ভিডিওটি কতবার দেখা হয়েছে। এই মেট্রিক প্লেলিস্টের সব ভিডিওর ভিউ গণনা করে, সেগুলি যে চ্যানেলেরই হোক না কেন।

  • প্রতিটি প্লেলিস্ট রিপোর্টের জন্য, চ্যানেল রিপোর্ট ডকুমেন্টেশনে এখন এমন টেবিল অন্তর্ভুক্ত রয়েছে যা সেই রিপোর্টের জন্য কাজ করে এমন মেট্রিক দেখায়, API অনুরোধে isCurated ডাইমেনশন অন্তর্ভুক্ত আছে কিনা তার উপর নির্ভর করে। উদাহরণ দেখতে সময়-ভিত্তিক প্লেলিস্ট রিপোর্ট সংজ্ঞায়িত করা বিভাগটি দেখুন।

৪ ডিসেম্বর, ২০২৩

দুটি insightTrafficSourceType ডাইমেনশন ভ্যালু মার্জ করার জন্য YouTube Analytics (টার্গেট করা কোয়েরি) API আপডেট করা হয়েছে। আগে, প্লেলিস্টের অংশ হিসেবে চালানো ভিডিও (PLAYLIST) এবং প্লেলিস্টের সব ভিডিওর তালিকা আছে এমন পৃষ্ঠা থেকে আসা ভিউয়ের (YT_PLAYLIST_PAGE) মধ্যে ডাইমেনশন পার্থক্য করত। এখন থেকে, দুই ধরনের ভিউই PLAYLIST ডাইমেনশন ভ্যালুর সাথে যুক্ত থাকবে।

১৫ ডিসেম্বর, ২০২২

YouTube Analytics (টার্গেট করা কোয়েরি) API দুটি নতুন ডাইমেনশন ও একটি নতুন রিপোর্টের সাথে কাজ করে:

  • নতুন রিপোর্টে শহর অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি দেখানো হয়। এই রিপোর্ট চ্যানেল এবং কন্টেন্টের মালিক দেখতে পাবেন। এই রিপোর্টে নতুন city ডাইমেনশন রয়েছে, যা ব্যবহারকারীর অ্যাক্টিভিটি কোন শহরে হয়েছে সেই সম্পর্কে YouTube-এর অনুমান শনাক্ত করে।

  • নতুন creatorContentType ডাইমেনশন YouTube কন্টেন্টের ধরন শনাক্ত করে যা ডেটা সারিতে ব্যবহারকারীর অ্যাক্টিভিটি মেট্রিকের সাথে সম্পর্কিত। সাপোর্ট করা ভ্যালু হল LIVE_STREAM, SHORTS, STORY এবং VIDEO_ON_DEMAND।

    creatorContentType ডাইমেনশনটি সব চ্যানেল এবং কন্টেন্ট মালিকের ভিডিও রিপোর্টের জন্য একটি ঐচ্ছিক ডাইমেনশন হিসেবে সমর্থিত।

  • YouTube Analytics API স্যাম্পেল অনুরোধ সংক্রান্ত গাইডে এখন দুটি নতুন ডাইমেনশনের উদাহরণ অন্তর্ভুক্ত করা হয়েছে।

  • 7DayTotals এবং 30DayTotals ডাইমেনশনের রেফারেন্স ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। এইসব ডাইমেনশন বন্ধ করে দেওয়ার কথা অক্টোবর ২০১৯-এ ঘোষণা করা হয়েছিল।

২৬ আগস্ট, ২০২২

YouTube Analytics (টার্গেট করা কোয়েরি) API এবং YouTube Reporting (বাল্ক রিপোর্ট) API, দুটিই নতুন ট্রাফিক সোর্স ডিটেল ভ্যালু সাপোর্ট করে:

  • YouTube Analytics API (টার্গেট করা কোয়েরি) API-তে, insightTrafficSourceType ডাইমেনশনের ভ্যালু SUBSCRIBER হলে, insightTrafficSourceDetail ভ্যালু podcasts-এ সেট করা যেতে পারে, যা দেখায় যে ট্রাফিক পডকাস্ট ডেস্টিনেশন পৃষ্ঠা থেকে রেফার করা হয়েছে।
  • YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API-তে, traffic_source_type ডাইমেনশনের ভ্যালু 3 হলে, traffic_source_detail ভ্যালু podcasts-এ সেট করা যেতে পারে, যা নির্দেশ করে যে ট্রাফিক পডকাস্ট ডেস্টিনেশন পৃষ্ঠা থেকে রেফার করা হয়েছে।

১১ ফেব্রুয়ারি, ২০২২

gender ডাইমেনশনের জন্য সঠিক ভ্যালুর সেট ১১ আগস্ট, ২০২২ বা তার পরে পরিবর্তন করা হবে। এটি আপনার API প্রয়োগে ব্যাকওয়ার্ড ইনকমপ্যাটিবিলিটি সংক্রান্ত পরিবর্তন হতে পারে। YouTube API পরিষেবার পরিষেবার শর্তাবলীর ব্যাকওয়ার্ড ইনকমপ্যাটিবিলিটি সংক্রান্ত পরিবর্তন বিভাগ অনুযায়ী, এই পরিবর্তন কার্যকর হওয়ার ছয় মাস আগে ঘোষণা করা হচ্ছে। নতুন সেট অফ ভ্যালুতে নির্বিঘ্নে ট্রানজিশন নিশ্চিত করতে, ১১ আগস্ট, ২০২২-এর আগে আপনার API ইমপ্লিমেন্টেশন আপডেট করুন।

যেসব নির্দিষ্ট পরিবর্তন করা হচ্ছে সেগুলি হল:

  • YouTube Analytics (টার্গেট করা কোয়েরি) API-তে, gender ডাইমেনশন বর্তমানে দুটি ভ্যালুর সাথে কাজ করে: female এবং male। ১১ আগস্ট, ২০২২ বা তার পরে, সেই ডাইমেনশন তিনটি ভ্যালু সাপোর্ট করবে: female, male এবং user_specified।
  • YouTube Reporting (বাল্ক রিপোর্ট) API-তে, gender ডাইমেনশন বর্তমানে তিনটি ভ্যালু সাপোর্ট করে: FEMALE, MALE এবং GENDER_OTHER। ১১ আগস্ট, ২০২২ বা তার পরে, কাজ করে এমন ভ্যালুর সেট পরিবর্তন হয়ে FEMALE, MALE এবং USER_SPECIFIED হয়ে যাবে।

৯ ফেব্রুয়ারি, ২০২২

১৩ ডিসেম্বর, ২০২১ থেকে লুপ করা ক্লিপ ট্রাফিক বাদ দেওয়ার জন্য দুটি মেট্রিক আপডেট করা হয়েছে। এই পরিবর্তন YouTube Analytics (টার্গেট করা কোয়েরি) API এবং YouTube Reporting (বাল্ক রিপোর্ট) API, দুটির উপরেই প্রভাব ফেলে।

২ ফেব্রুয়ারি, ২০২২

এই YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API নতুন ট্রাফিক সোর্স ডাইমেনশন ভ্যালু সাপোর্ট করে যা দেখায় যে ভিউ লাইভ রিডাইরেক্ট থেকে এসেছে:

  • YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API-তে, traffic_source_type ডাইমেনশন 28 ভ্যালু সাপোর্ট করে।

এই ট্রাফিক সোর্সের ধরনের জন্য, traffic_source_detail ডাইমেনশন সেই চ্যানেল আইডি উল্লেখ করে যেখান থেকে দর্শককে রেফার করা হয়েছে।

২৩ সেপ্টেম্বর, ২০২০

YouTube Analytics (টার্গেট করা কোয়েরি) API এবং YouTube Reporting (বাল্ক রিপোর্ট) API, উভয়ই নতুন ট্রাফিক সোর্স ডাইমেনশন ভ্যালু সাপোর্ট করে যা দেখায় যে YouTube Shorts দেখার অভিজ্ঞতায় ভার্টিক্যালি সোয়াইপ করার মাধ্যমে দর্শককে রেফার করা হয়েছে:

  • YouTube Analytics API (টার্গেট করা কোয়েরি) API-তে, insightTrafficSourceType ডাইমেনশন SHORTS ভ্যালুর সাথে কাজ করে।
  • YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API-তে, traffic_source_type ডাইমেনশন 24 ভ্যালু সাপোর্ট করে।

ট্রাফিক সোর্সের বিবরণ সংক্রান্ত ডাইমেনশন — insightTrafficSourceDetail YouTube Analytics API-তে অথবা traffic_source_detail YouTube Reporting API-তে — এই নতুন ধরনের ট্রাফিক সোর্সের জন্য পপুলেট করা হয় না।

২০ জুলাই, ২০২০

এই আপডেটে দুটি পরিবর্তন করা হয়েছে যা YouTube Analytics (টার্গেট করা কোয়েরি) API-কে প্রভাবিত করে:

  • YouTube Analytics রিপোর্টিং গ্রুপের সর্বাধিক সাইজ ২০০ থেকে ৫০০ এন্টিটিতে বাড়ানো হয়েছে।
  • reports.query পদ্ধতির filters প্যারামিটার ফিল্টারের একটি তালিকা শনাক্ত করে যা YouTube Analytics ডেটা পুনরুদ্ধার করার সময় প্রয়োগ করা উচিত। প্যারামিটারটি video, playlist, এবং channel ফিল্টারের জন্য একাধিক মান নির্দিষ্ট করার ক্ষমতাকে সমর্থন করে এবং সেই ফিল্টারগুলির জন্য নির্দিষ্ট করা যেতে পারে এমন আইডির সর্বাধিক সংখ্যা ২০০ থেকে ৫০০ আইডিতে বৃদ্ধি পেয়েছে।

১৩ ফেব্রুয়ারি, ২০২০

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API এবং YouTube Reporting (বাল্ক রিপোর্ট) API সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে। আপনি এইসব পরিবর্তনের ব্যাপারে YouTube সহায়তা কেন্দ্র থেকে আরও জানতে পারবেন।

দুটি API-তেই, বিজ্ঞপ্তির জন্য সম্ভাব্য ট্রাফিক সোর্সের বিবরণ সংক্রান্ত ভ্যালুর সেট পরিবর্তন করা হচ্ছে। টার্গেট করা কোয়েরিতে, বিজ্ঞপ্তি insightTrafficSourceType=NOTIFICATION হিসেবে রিপোর্ট করা হয়। বাল্ক রিপোর্টে, বিজ্ঞপ্তিগুলি traffic_source_type=17 হিসেবে রিপোর্ট করা হয়।

নতুন ভ্যালু আপলোড করা ভিডিও এবং লাইভ স্ট্রিম সম্পর্কিত বিজ্ঞপ্তিগুলিকে দুটি বিভাগে বিভক্ত করে, যা আগে uploaded হিসেবে রিপোর্ট করা হয়েছিল:

  • uploaded_push - ভিডিও আপলোড করার সময় সাবস্ক্রাইবারদের পাঠানো পুশ বিজ্ঞপ্তি থেকে পাওয়া ভিউ
  • uploaded_other - পুশ বিজ্ঞপ্তি নয় এমন বিজ্ঞপ্তি থেকে পাওয়া ভিউ, যেমন ভিডিও আপলোড করার সময় সাবস্ক্রাইবারদের পাঠানো ইমেল বা ইনবক্স বিজ্ঞপ্তি।

এই ভ্যালুগুলি ১৩-০১-২০২০ (১৩ জানুয়ারি, ২০২০) থেকে শুরু হওয়া সময়সীমার জন্য দেখানো হয়েছে।

এছাড়াও, মনে রাখবেন যে এই ভ্যালুগুলি বিজ্ঞপ্তি নয়, বরং ট্রাফিক সোর্স যা নির্দিষ্ট কিছু YouTube ভিউতে নিয়ে যায়। যেমন, কোনও রিপোর্টের সারিতে views=3, traffic_source_type=17 (NOTIFICATION) এবং traffic_source_detail=uploaded_push থাকলে, সারিটি ইঙ্গিত করে যে ভিডিও আপলোড করার সময় পাঠানো পুশ বিজ্ঞপ্তিতে ক্লিক করার ফলে তিনটি ভিউ হয়েছে।

১৫ অক্টোবর, ২০১৯

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    YouTube থেকে 7DayTotals এবং 30DayTotals ডাইমেনশন সরিয়ে দেওয়া হচ্ছে। আপনি ১৫ এপ্রিল, ২০২০ পর্যন্ত সেইসব ডাইমেনশন ব্যবহার করে ডেটা ফিরিয়ে আনতে পারবেন। সেই তারিখে বা তার পরে, 7DayTotals বা 30DayTotals ডাইমেনশন ব্যবহার করে রিপোর্ট ফিরিয়ে আনার চেষ্টা করলে, একটি সমস্যা সংক্রান্ত মেসেজ দেখানো হবে।

    মনে রাখবেন যে ব্যবহারকারীরা day ডাইমেনশন ব্যবহার করে কোয়েরি করার মাধ্যমে এবং সাত বা ৩০ দিনের সময়সীমা জুড়ে ডেটা একত্রিত বা প্রাপ্ত করার মাধ্যমে এইসব ডাইমেনশনের জন্য কিছু ডেটা আবার তৈরি করতে পারবেন। যেমন:

    • সাত দিনের সময়সীমার জন্য ভিউয়ের সংখ্যা, সেই সময়সীমার প্রতিটি দিনের ভিউয়ের সংখ্যা একত্রিত করে গণনা করা যেতে পারে।
    • সাত দিনের সময়সীমার জন্য viewerPercentage হিসেব করতে, প্রতিদিনের ভিউয়ের সংখ্যাকে সেই দিনের viewerPercentage দিয়ে গুণ করতে হবে। এর ফলে, সেই দিন ভিডিও দেখার সময় কতজন দর্শক লগ-ইন করেছিলেন তা জানা যাবে। তারপর, সম্পূর্ণ সময়সীমার জন্য লগ-ইন করা দর্শকের সংখ্যা যোগ করা যেতে পারে এবং সম্পূর্ণ সময়সীমার জন্য viewerPercentage পেতে সেই সময়সীমার জন্য মোট ভিউয়ের সংখ্যা দিয়ে ভাগ করা যেতে পারে।
    • সাত দিনের সময়সীমার জন্য অনন্য দর্শকের সংখ্যা গণনা করা যাবে না, কারণ একই দর্শককে বিভিন্ন দিনে অনন্য দর্শক হিসেবে গণনা করা হতে পারে। তবে, ৩০ দিনের সময়সীমার মধ্যে অনন্য দর্শকের সংখ্যা সম্পর্কে ডেটা এক্সট্রাপোলেট করতে, আপনি 30DayTotals ডাইমেনশনের পরিবর্তে month ডাইমেনশন ব্যবহার করতে পারবেন। মনে রাখবেন যে month ডাইমেনশন ক্যালেন্ডার মাসকে বোঝায়, যেখানে 30DayTotals ডাইমেনশন নির্দিষ্ট শুরু ও শেষের তারিখের ভিত্তিতে ৩০ দিনের সময়সীমা গণনা করে।

২৭ জুন, ২০১৯

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API-এর ভার্সন ১ এখন সম্পূর্ণভাবে বন্ধ হয়ে গেছে, তাই সেই ভার্সনের রেফারেন্স সরিয়ে দেওয়ার জন্য ডকুমেন্টেশন আপডেট করা হয়েছে, এর মধ্যে বন্ধ হয়ে যাওয়ার বিজ্ঞপ্তি এবং ভার্সন ২-এ কীভাবে আপডেট করতে হবে তা ব্যাখ্যা করে মাইগ্রেশন গাইড অন্তর্ভুক্ত আছে।

১ নভেম্বর, ২০১৮

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API-এর ভার্সন ১ এখন বন্ধ করে দেওয়া হয়েছে। আপনি যদি এখনও তা না করে থাকেন, তাহলে পরিষেবায় বিঘ্ন ঘটার সম্ভাবনা কমাতে যত তাড়াতাড়ি সম্ভব API-এর ভার্সন ২ ব্যবহার করার জন্য আপনার API ক্লায়েন্ট আপডেট করুন। আরও তথ্যের জন্য মাইগ্রেশন গাইড দেখুন।

    মনে রাখবেন যে এই বন্ধ করার শিডিউলটি মূলত ২৬ এপ্রিল, ২০১৮-এ ঘোষণা করা হয়েছিল।

১৭ সেপ্টেম্বর, ২০১৮

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • ডেটা মডেল ওভারভিউ ডকুমেন্টের নতুন ডেটা অ্যানোনিমাইজেশন বিভাগে ব্যাখ্যা করা হয়েছে যে মেট্রিক নির্দিষ্ট থ্রেশহোল্ড পূরণ করতে না পারলে, কিছু YouTube Analytics ডেটা সীমিত করা হয়। এটি বিভিন্ন ক্ষেত্রে ঘটতে পারে। বাস্তবে, এর অর্থ হল কোনও রিপোর্টে আপনার সমস্ত (বা কোনও) ডেটা নাও থাকতে পারে যদি:

    1. একটি নির্দিষ্ট সময়সীমার মধ্যে কোনও ভিডিও বা চ্যানেলে সীমিত ট্রাফিক থাকলে,

      অথবা

    2. আপনি ট্রাফিক সোর্স বা দেশের মতো এমন কোনও ফিল্টার বা ডাইমেনশন বেছে নিয়েছেন, যেগুলির ভ্যালু নির্দিষ্ট থ্রেশহোল্ড পূরণ করে না।

    নতুন বিভাগে YouTube Analytics রিপোর্টে সীমিত হতে পারে এমন ডেটার ধরন সম্পর্কে আলোচনাও অন্তর্ভুক্ত করা হয়েছে।

  • চ্যানেল রিপোর্ট এবং কন্টেন্টের মালিকের রিপোর্ট সংক্রান্ত ডকুমেন্ট আপডেট করা হয়েছে যাতে বোঝা যায় যে প্লেব্যাক লোকেশন, ট্রাফিক সোর্স এবং ডিভাইসের ধরন/অপারেটিং সিস্টেম রিপোর্টে redViews এবং estimatedRedMinutesWatched মেট্রিক আর কাজ করে না।

১৮ জুন, ২০১৮

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • নিম্নলিখিত পদ্ধতির জন্য স্কোপ সংক্রান্ত প্রয়োজনীয়তা পরিবর্তন করা হয়েছে:
    • reports.query পদ্ধতিতে করা অনুরোধের ক্ষেত্রে https://www.googleapis.com/auth/youtube.readonly স্কোপে অ্যাক্সেস থাকতে হবে।
    • groupItems.list পদ্ধতিতে অনুরোধের ক্ষেত্রে এগুলির মধ্যে যেকোনও একটিতে অ্যাক্সেস থাকতে হবে:
      • https://www.googleapis.com/auth/youtube স্কোপ
        বা
      • https://www.googleapis.com/auth/youtube.readonly স্কোপ
        এবং
        https://www.googleapis.com/auth/yt-analytics.readonly স্কোপ

      প্রথম বিকল্পটি একটি স্কোপ ব্যবহার করে, যা রিড-রাইট স্কোপ, আর দ্বিতীয় বিকল্পটি দুটি রিড-অনলি স্কোপ ব্যবহার করে।

২৩ মে, ২০১৮

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • API ওভারভিউতে একটি নতুন বিভাগ আছে, মোট মেট্রিক এবং মুছে ফেলা আইটেম, যা ব্যাখ্যা করে যে API রেসপন্স কীভাবে মুছে ফেলা রিসোর্স, যেমন ভিডিও, প্লেলিস্ট বা চ্যানেলের সাথে সম্পর্কিত ডেটা ম্যানেজ করে।
  • API ওভারভিউয়ের পেশাদার পদ্ধতি বিভাগটি আপডেট করা হয়েছে যাতে আপনাকে মনে করিয়ে দেওয়া যায় যে YouTube Analytics API রেসপন্সে শনাক্ত করা রিসোর্সের জন্য অতিরিক্ত মেটাডেটা পেতে আপনি YouTube Data API ব্যবহার করতে পারেন। YouTube API পরিষেবা ডেভেলপার নীতি (III.E.4.b থেকে III.E.4.d বিভাগ) অনুযায়ী, API ক্লায়েন্টকে ৩০ দিন পরে সেই API থেকে সেভ করা রিসোর্স মেটাডেটা মুছে দিতে বা রিফ্রেশ করতে হবে।

২২ মে, ২০১৮

এই আপডেটে YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • নিম্নলিখিত পরিবর্তনগুলি জুলাই ২০১৮ থেকে কার্যকর করার জন্য শিডিউল করা হয়েছে এবং নতুন নীতিগুলি বিশ্বব্যাপী সমস্ত রিপোর্ট এবং রিপোর্টিং কাজের ক্ষেত্রে প্রযোজ্য হবে।

    • পরিবর্তনের পরে, ব্যাকফিল রিপোর্ট সহ বেশিরভাগ API রিপোর্ট, জেনারেট হওয়ার সময় থেকে ৬০ দিন পর্যন্ত উপলভ্য থাকবে। তবে, পুরনো ডেটা সহ রিপোর্ট জেনারেট হওয়ার সময় থেকে ৩০ দিন পর্যন্ত উপলভ্য থাকবে।

      এই ঘোষণার আগে, সমস্ত API রিপোর্ট জেনারেট হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য ছিল। স্পষ্ট করে বলতে গেলে, এই নীতিতে পরিবর্তন কার্যকর হলে, ৩০ দিনের বেশি পুরনো ঐতিহাসিক ডেটা রিপোর্টও API-এর মাধ্যমে আর অ্যাক্সেস করা যাবে না। এছাড়াও, ৬০ দিনের বেশি পুরনো অন্যান্য রিপোর্টও আর অ্যাক্সেস করা যাবে না। সেই কারণে, ডকুমেন্টেশনে এখন উল্লেখ করা হয়েছে যে নীতি পরিবর্তনের আগে তৈরি করা রিপোর্ট সর্বাধিক ১৮০ দিন পর্যন্ত উপলভ্য থাকবে।

    • পরিবর্তনের পরে, আপনি রিপোর্টিং জব শিডিউল করলে, YouTube সেই দিন থেকে রিপোর্ট তৈরি করবে এবং জব শিডিউল করার ৩০ দিন আগে পর্যন্ত সময়সীমা কভার করবে। পরিবর্তনের আগে, আপনি রিপোর্টিং জব শিডিউল করলে, YouTube জব শিডিউল করার সময় থেকে শুরু করে তার আগের ১৮০ দিনের সময়সীমা কভার করে রিপোর্ট তৈরি করবে।

  • পেশাদার পদ্ধতি বিভাগটি আপডেট করা হয়েছে যাতে আপনাকে মনে করিয়ে দেওয়া যায় যে রিপোর্টে শনাক্ত করা রিসোর্সের জন্য অতিরিক্ত মেটাডেটা পেতে আপনি YouTube Data API ব্যবহার করতে পারবেন। YouTube API পরিষেবা ডেভেলপার নীতি (III.E.4.b থেকে III.E.4.d বিভাগ) অনুযায়ী, API ক্লায়েন্টকে ৩০ দিন পরে সেই API থেকে সেভ করা রিসোর্স মেটাডেটা মুছে দিতে বা রিফ্রেশ করতে হবে।

  • রিপোর্টের বৈশিষ্ট্য বিভাগটি আপডেট করা হয়েছে যাতে উল্লেখ করা হয় যে, যদিও রিপোর্টের ডেটা ফিল্টার করা হয় না, তবুও ১ জুন, ২০১৮ বা তার পরে কোনও সময়কালের ডেটা সহ রিপোর্টে YouTube রিসোর্সের কোনও রেফারেন্স থাকবে না যা রিপোর্ট তৈরি হওয়ার তারিখের কমপক্ষে ৩০ দিন আগে মুছে ফেলা হয়েছে।

  • API ওভারভিউয়ের ঐতিহাসিক ডেটা বিভাগ আপডেট করা হয়েছে যাতে আপনি নতুন রিপোর্টিং জব শিডিউল করলে, ঐতিহাসিক রিপোর্ট সাধারণত কয়েক দিনের মধ্যে পোস্ট করা হয়। আগে, ডকুমেন্টেশনে উল্লেখ করা ছিল যে এই ধরনের রিপোর্ট উপলভ্য হতে ৩০ দিন পর্যন্ত সময় লাগতে পারে।

  • API ওভারভিউয়ের ব্যাকফিল ডেটা বিভাগটি আপডেট করা হয়েছে যাতে ব্যাকফিল ডেটা-কে আরও স্পষ্টভাবে এমন একটি ডেটা সেট হিসেবে সংজ্ঞায়িত করা যায় যা আগে ডেলিভার করা সেটকে প্রতিস্থাপন করে।

২৬ এপ্রিল, ২০১৮

YouTube Analytics (টার্গেট করা কোয়েরি) API (v2)-এর ভার্সন ২ এখন সর্বজনীনভাবে উপলভ্য। নিম্নলিখিত তালিকা থেকে নতুন API ভার্সন সম্পর্কিত প্রোডাক্ট ও ডকুমেন্টেশনে হওয়া পরিবর্তনগুলি শনাক্ত করা যায়:

  • v2 API প্রায় v1 API-এর মতোই। তবে, নিচে তালিকাভুক্ত পরিবর্তনগুলি দেখানোর জন্য আপনাকে সম্ভবত কোড আপডেট করতে হবে। এইসব পরিবর্তন নতুন মাইগ্রেশন গাইড-এ বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

    • API-এর ভার্সন v1 থেকে v2-এ পরিবর্তন করা হয়েছে।
    • API অনুরোধের জন্য বেস URL https://www.googleapis.com/youtube/analytics/v1 থেকে https://youtubeanalytics.googleapis.com/v2-এ পরিবর্তন করা হয়েছে।
    • reports.query পদ্ধতির জন্য একাধিক প্যারামিটারের নাম আপডেট করা হয়েছে। বিশেষ করে, হাইফেন আছে এমন প্যারামিটারের নাম, যেমন v1 API-তে end-date, v2 API-তে হাইফেনের পরিবর্তে ক্যামেল কেস (endDate) ব্যবহার করে। এই পরিবর্তনের ফলে API জুড়ে প্যারামিটারের নাম একই রকম থাকে, কারণ গ্রুপ তৈরি ও ম্যানেজ করার জন্য API-এর পদ্ধতিতে প্যারামিটারের নামের জন্য আগে থেকেই ক্যামেল কেস ব্যবহার করা হয়।
    • v2 API, Google-এর গ্লোবাল HTTP ব্যাচ এন্ডপয়েন্টে (www.googleapis.com/batch) পাঠানো ব্যাচ অনুরোধ সমর্থন করে না। আপনি v2 API-তে ব্যাচ অনুরোধ পাঠালে, আপনাকে পরিবর্তে এন্ডপয়েন্ট https://youtubeanalytics.googleapis.com/v2 ব্যবহার করতে হবে।

    এছাড়াও, v2 API-তে v1-এর কিছু ফিচার কাজ করে না:

    • reports.query পদ্ধতিতে আর alt, quotaUser ও userIp অনুরোধের প্যারামিটার কাজ করে না।
    • v2 API কোনও ব্যাচ এন্ডপয়েন্ট প্রদান করে না যা বিভিন্ন API-তে অনুরোধের সমন্বয়ে গঠিত ব্যাচকে সমর্থন করে। (তবে, একই API-এর বিভিন্ন পদ্ধতিতে করা অনুরোধ নিয়ে একটি ব্যাচ তৈরি হতে পারে।) এই অবচয় YouTube Analytics API-এর জন্য নির্দিষ্ট নয় কারণ Google তার সমস্ত API জুড়ে গ্লোবাল ব্যাচ এন্ডপয়েন্ট অবচয় করছে।
    • v2 API-তে JSON-RPC প্রোটোকল কাজ করে না, যা API v1-এ কাজ করত। আবার, এই অবচিতি YouTube Analytics API-এর জন্য নির্দিষ্ট নয়।

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    API-এর ভার্সন ১ (v1) এখন বন্ধ করে দেওয়া হয়েছে এবং ৩১ অক্টোবর, ২০১৮ পর্যন্ত কাজ করবে। v1 API-তে করা সব অনুরোধ সেই তারিখের পরে কাজ করা বন্ধ করে দেবে। তাই, API-এর মাধ্যমে YouTube Analytics ডেটা অ্যাক্সেস করার ক্ষেত্রে কোনও বাধা এড়াতে, ৩১ অক্টোবর, ২০১৮-এর মধ্যে v2 API-তে আপগ্রেড করতে ভুলবেন না।

২১ ফেব্রুয়ারি, ২০১৮

এই আপডেটে YouTube Analytics (টার্গেট করা কোয়েরি) API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • দর্শকের ডেমোগ্রাফিক রিপোর্ট, যা দর্শকের বয়স এবং লিঙ্গের উপর ভিত্তি করে দেখার পরিসংখ্যান এগ্রিগেট করে, সেটি আর youtubeProduct ডাইমেনশনকে সাপোর্ট করে না, যা ব্যবহারকারীর অ্যাক্টিভিটি কোন YouTube পরিষেবায় ঘটেছে তা শনাক্ত করে।

১৮ জানুয়ারি, ২০১৮

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Reporting API (বাল্ক রিপোর্ট)

    • operating_system ডাইমেনশন, যা ভিউ হওয়া ডিভাইসের সফ্টওয়্যার সিস্টেম শনাক্ত করে, এখন নিম্নলিখিত ভ্যালু সাপোর্ট করে:
      • 25: KaiOS

  • YouTube Analytics API (টার্গেট করা কোয়েরি)

    • operatingSystem ডাইমেনশন KAIOS ডাইমেনশন ভ্যালুর সাথে কাজ করে।

২০ ডিসেম্বর, ২০১৭

এই আপডেটে YouTube Reporting API সম্পর্কিত দুটি পরিবর্তন রয়েছে:

  • API সার্ভার এখন রিপোর্ট ডাউনলোড করার অনুরোধের জন্য gzip কম্প্রেশন সাপোর্ট করে। মনে রাখবেন যে অন্যান্য ধরনের API অনুরোধের জন্য gzip কম্প্রেশন কাজ করে না। gzip কম্প্রেশন চালু করলে প্রতিটি API রেসপন্সের জন্য প্রয়োজনীয় ব্যান্ডউইথ কমে যায়। এছাড়াও, API রেসপন্স আনকম্প্রেস করার জন্য আপনার অ্যাপ্লিকেশনের অতিরিক্ত সিপিইউ টাইম প্রয়োজন হলেও, কম নেটওয়ার্ক রিসোর্স ব্যবহার করার সুবিধা সাধারণত সেই খরচের চেয়ে বেশি হয়।

    gzip-এনকোড করা উত্তর পেতে, Accept-Encoding HTTP অনুরোধ হেডারটি gzip-এ সেট করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

    Accept-Encoding: gzip

    এই কার্যকারিতা API ওভারভিউ এবং report রিসোর্সের downloadUrl প্রপার্টির সংজ্ঞায় ব্যাখ্যা করা হয়েছে।

  • age group এবং gender ডাইমেনশনের ডকুমেন্টেশন সংশোধন করা হয়েছে যাতে API সেই ডাইমেনশনের জন্য যে প্রকৃত মান রিটার্ন করে তা দেখানো যায়। মনে রাখবেন যে এটি একটি ডকুমেন্টেশন সংশোধন এবং API কার্যকারিতা বা আচরণে পরিবর্তন প্রতিফলিত করে না। বিশেষ করে, নিম্নলিখিত ভ্যালু পরিবর্তন করা হয়েছে:

    • age_group ডাইমেনশনের ভ্যালু বড় হাতের অক্ষর ব্যবহার করে, AGE শব্দ এবং বয়স গ্রুপের সংখ্যার মধ্যে আন্ডারস্কোর থাকে এবং হাইফেনের পরিবর্তে আন্ডারস্কোর ব্যবহার করে। সেই কারণে, age13-17 এবং age18-24-এর মতো ভ্যালু যথাক্রমে AGE_13_17 এবং AGE_18_24-এ সংশোধন করা হয়েছে।
    • gender ডাইমেনশনের জন্য বড় হাতের অক্ষর ব্যবহার করুন। তাই, female, male ও gender_other ভ্যালু সংশোধন করে FEMALE, MALE ও GENDER_OTHER করা হয়েছে।

১০ আগস্ট, ২০১৭

১০ আগস্ট, ২০১৬-এ, এই ডকুমেন্টেশনে YouTube Analytics API-এর earnings মেট্রিক বন্ধ করার ঘোষণা করা হয়েছে। (একই সাথে, API-তে estimatedRevenue নামের নতুন মেট্রিকের জন্য সহায়তা যোগ করা হয়েছে, যা একই ডেটা প্রদান করে।)

earnings মেট্রিকটি একটি মূল মেট্রিক ছিল, তাই এটি ঘোষণার তারিখ থেকে এক বছরের জন্য কাজ করেছে। তবে, এক বছরের সেই সময়সীমা শেষ হয়ে যাওয়ায়, earnings মেট্রিক আর কাজ করে না। এর ফলে, API অনুরোধ যা earnings মেট্রিক নির্দিষ্ট করে তা এখন 400 HTTP রেসপন্স কোড ফিরিয়ে দেয়। আপনি যদি earnings মেট্রিকের পরিবর্তে estimatedRevenue মেট্রিক ব্যবহার করার জন্য আপনার অ্যাপটি এখনও আপডেট না করে থাকেন, তাহলে যত তাড়াতাড়ি সম্ভব তা করুন।

earnings মেট্রিকের বাকি রেফারেন্স সরিয়ে দেওয়ার জন্য API ডকুমেন্টেশন আপডেট করা হয়েছে।

৬ জুলাই, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Analytics API (টার্গেট করা কোয়েরি)

    • API ডকুমেন্টেশন আপডেট করা হয়েছে যাতে এটি বোঝা যায় যে API রেসপন্সে অনুরোধ করা তারিখের রেঞ্জের শেষ দিন পর্যন্ত ডেটা থাকে, যার জন্য কোয়েরি করা সমস্ত মেট্রিক উপলভ্য।

      যেমন, কোনও অনুরোধে যদি শেষ তারিখ ৫ জুলাই, ২০১৭ উল্লেখ করা থাকে এবং অনুরোধ করা সব মেট্রিকের ভ্যালু শুধুমাত্র ৩ জুলাই, ২০১৭ পর্যন্ত উপলভ্য থাকে, তাহলে সেই তারিখ পর্যন্ত ডেটা উত্তরে অন্তর্ভুক্ত করা হবে। (এমনকি অনুরোধ করা কিছু মেট্রিকের ডেটা ৪ জুলাই, ২০১৭-এর জন্য উপলভ্য হলেও এটি প্রযোজ্য।)

    • adType ডাইমেনশন এখন reservedBumperInstream ভ্যালু সাপোর্ট করে, যা সর্বাধিক ৬ সেকেন্ডের স্কিপ করার সুবিধা না থাকা ভিডিও বিজ্ঞাপনকে বোঝায় এবং কোনও ভিডিও দেখার আগে এটি দেখানো হয়। বিজ্ঞাপনের ফর্ম্যাটটি auctionBumperInstream বিজ্ঞাপনের মতোই, তবে এই ধরনের বিজ্ঞাপন নিলামের পরিবর্তে রিজার্ভেশনের ভিত্তিতে বিক্রি করা হয়।

  • YouTube Reporting API (বাল্ক রিপোর্ট)

    • ad_type ডাইমেনশন এখন 20 ভ্যালু সাপোর্ট করে, যা রিজার্ভ করা ভিত্তিতে বিক্রি করা বাম্পার বিজ্ঞাপনকে বোঝায়। বাম্পার বিজ্ঞাপন হল স্কিপ করার সুবিধা না থাকা ভিডিও বিজ্ঞাপন যা সর্বাধিক ৬ সেকেন্ডের হয় এবং কোনও ভিডিও দেখার আগে দেখানো হয়। মনে রাখবেন যে এই ডাইমেনশনের জন্য 19 ভ্যালু বাম্পার বিজ্ঞাপনকেও বোঝায় যা রিজার্ভ করা ভিত্তিতে নয় বরং নিলাম-এর ভিত্তিতে বিক্রি করা হয়।

    • নিম্নলিখিত YouTube Reporting API রিপোর্টের জন্য রিপোর্টিং কাজ মুছে ফেলা হয়েছে:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      এই ধরনের রিপোর্ট ১৫ সেপ্টেম্বর, ২০১৬ থেকে বন্ধ করে দেওয়া হয়েছে এবং ১৫ ডিসেম্বর, ২০১৬-এর পর থেকে এই ধরনের রিপোর্ট আর তৈরি করা হয় না। আগে জেনারেট করা রিপোর্ট, জেনারেট হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য ছিল। তাই, কিছু রিপোর্ট ১৫ জুন, ২০১৭ পর্যন্ত অ্যাক্সেস করা গেছে। তবে, যেহেতু রিপোর্ট আর উপলভ্য নেই, তাই রিপোর্টের সাথে যুক্ত জবও আর প্রয়োজন নেই।

২৪ মে, ২০১৭

নিম্নলিখিত YouTube Reporting API রিপোর্টের জন্য সব রিপোর্টিং কাজ মুছে ফেলা হয়েছে:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

এই ধরনের রিপোর্ট ২২ জুন, ২০১৬ থেকে বন্ধ করে দেওয়া হয়েছে এবং ২২ সেপ্টেম্বর, ২০১৬-এর পর থেকে এই ধরনের রিপোর্ট আর তৈরি করা হয় না। আগে জেনারেট করা রিপোর্ট, জেনারেট হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য ছিল। তাই, কিছু রিপোর্ট ২২ মার্চ, ২০১৭ পর্যন্ত অ্যাক্সেস করা গেছে। তবে, যেহেতু রিপোর্ট আর উপলভ্য নেই, তাই রিপোর্টের সাথে যুক্ত জবও আর প্রয়োজন নেই।

২২ মে, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Reporting API (বাল্ক রিপোর্ট)

    • sharing_service ডাইমেনশন, যা ভিডিও শেয়ার করার জন্য ব্যবহৃত পরিষেবা শনাক্ত করে, এখন নিম্নলিখিত ভ্যালু সমর্থন করে:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      এছাড়াও, 52 ভ্যালু শনাক্ত করার জন্য ব্যবহৃত নামটি ডকুমেন্টেশনে Kakao (Kakao Talk)-এ আপডেট করা হয়েছে যাতে এটিকে 73 (Kakao Story) ভ্যালু থেকে আরও স্পষ্টভাবে আলাদা করা যায়। এই পরিবর্তনের ফলে API-এর আচরণ বা এইসব পরিষেবার সাথে শেয়ার করা ভিডিওর শ্রেণীবিভাগে কোনও পরিবর্তন হবে না।

  • YouTube Analytics API (টার্গেট করা কোয়েরি)

    • sharingService ডাইমেনশন এখন নিম্নলিখিত ভ্যালু সাপোর্ট করে:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

২৮ মার্চ ২০১৭

যেসব চ্যানেলের মালিক Creator Studio-তে YouTube Analytics-এর মাধ্যমে উপার্জনের ডেটা অ্যাক্সেস করতে পারেন, তারা এখন YouTube Analytics API-এর মাধ্যমেও উপার্জনের ডেটা অ্যাক্সেস করতে পারবেন:

১৭ মার্চ ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Analytics API, redViews এবং estimatedRedMinutesWatched মেট্রিক্সে কাজ করে, এই দুটিই YouTube Red দর্শকসংখ্যার সাথে সম্পর্কিত। আসলে, API কিছু সময় ধরে এই মেট্রিকগুলি সাপোর্ট করেছে এবং YouTube Reporting API আগে থেকেই দুটি মেট্রিক সাপোর্ট করে, যেমন ১৫ সেপ্টেম্বর, ২০১৬-এ ঘোষণা করা হয়েছে।

    • redViews মেট্রিক থেকে জানা যায় যে YouTube Red মেম্বাররা কতবার কোনও ভিডিও দেখেছেন।
    • estimatedRedMinutesWatched মেট্রিক থেকে জানা যায় যে YouTube Red মেম্বাররা কত মিনিট ধরে কোনও ভিডিও দেখেছেন।

    কোন কোন রিপোর্ট দুটি নতুন মেট্রিককে সাপোর্ট করে তা দেখানোর জন্য চ্যানেল রিপোর্ট এবং কন্টেন্টের মালিকের রিপোর্ট সংক্রান্ত ডকুমেন্টেশন আপডেট করা হয়েছে। যেসব রিপোর্টে আগে থেকেই views এবং estimatedMinutesWatched মেট্রিক কাজ করে, সেগুলিতে এই মেট্রিকও কাজ করবে।

৩ মার্চ ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Reporting API (বাল্ক রিপোর্ট)

    • date ডাইমেনশনের সংজ্ঞা সংশোধন করে উল্লেখ করা হয়েছে যে ডাইমেনশনের ভ্যালু বলতে নির্দিষ্ট দিন, মাস ও বছরে প্যাসিফিক টাইম অনুযায়ী রাত ১২:০০টা থেকে শুরু করে রাত ১১:৫৯টা পর্যন্ত সময়সীমাকে বোঝায়। বছরের সময়ের উপর নির্ভর করে, প্যাসিফিক টাইম হয় UTC-7 অথবা UTC-8 হয়।

      যদিও তারিখ সাধারণত ২৪ ঘণ্টার সময়সীমাকে বোঝায়, তবে ঘড়ির সময় এগিয়ে নিয়ে যাওয়া হলে তারিখ ২৩ ঘণ্টার সময়সীমাকে বোঝায় এবং ঘড়ির সময় পিছিয়ে নিয়ে যাওয়া হলে তারিখ ২৫ ঘণ্টার সময়সীমাকে বোঝায়। (আগে, ডকুমেন্টেশনে বলা হয়েছিল যে প্রতিটি তারিখ ২৪ ঘণ্টার একটি অনন্য সময়সীমা দেখায় এবং প্যাসিফিক টাইম সবসময় UTC-8 ছিল।)

      মনে রাখবেন, এই সংশোধনের অর্থ এই নয় যে API-এর আসল আচরণে কোনও পরিবর্তন হয়েছে।

    • operating_system ডাইমেনশন, যা ভিউ হওয়া ডিভাইসের সফ্টওয়্যার সিস্টেম শনাক্ত করে, এখন নিম্নলিখিত ভ্যালুগুলি সাপোর্ট করে:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • content_owner_basic_a1 রিপোর্টের ধরনের জন্য সব রিপোর্টিং কাজ মুছে ফেলা হয়েছে। ১৯ আগস্ট, ২০১৬ থেকে এই ধরনের রিপোর্ট পুরোপুরি বন্ধ করে দেওয়া হয়েছে, তবে আগে তৈরি করা content_owner_basic_a1 রিপোর্ট, তৈরি হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য ছিল। তাই, কিছু রিপোর্ট ১৯ ফেব্রুয়ারি, ২০১৭ পর্যন্ত অ্যাক্সেস করা গেছে। তবে, যেহেতু রিপোর্ট আর উপলভ্য নেই, তাই রিপোর্টের সাথে যুক্ত জবও আর প্রয়োজন নেই।

  • YouTube Analytics API (টার্গেট করা কোয়েরি)

    • time periods-এর সাথে সম্পর্কিত ডাইমেনশনের বিবরণ সংশোধন করা হয়েছে যাতে উল্লেখ করা যায় যে ডাইমেনশনের ভ্যালু বলতে নির্দিষ্ট দিন, মাস ও বছরে প্যাসিফিক টাইম অনুযায়ী রাত ১২:০০টা থেকে শুরু করে রাত ১১:৫৯টা পর্যন্ত সময়সীমাকে বোঝায়। বছরের সময়ের উপর নির্ভর করে, প্যাসিফিক টাইম হয় UTC-7 অথবা UTC-8 হয়।

      যদিও তারিখ সাধারণত ২৪ ঘণ্টার সময়সীমাকে বোঝায়, তবে ঘড়ির সময় এগিয়ে নিয়ে যাওয়া হলে তারিখ ২৩ ঘণ্টার সময়সীমাকে বোঝায় এবং ঘড়ির সময় পিছিয়ে নিয়ে যাওয়া হলে তারিখ ২৫ ঘণ্টার সময়সীমাকে বোঝায়। (আগে, ডকুমেন্টেশনে বলা হয়েছিল যে প্যাসিফিক টাইম হল UTC-8 এবং একদিনে ২৪ ঘণ্টা নাও থাকতে পারে এমন সম্ভাবনার কথা উল্লেখ করা হয়নি।)

      মনে রাখবেন, এই সংশোধনের অর্থ এই নয় যে API-এর আসল আচরণে কোনও পরিবর্তন হয়েছে।

    • চ্যানেল রিপোর্ট সংক্রান্ত ডকুমেন্টেশন আপডেট করা হয়েছে যাতে উল্লেখ করা হয়েছে যে চ্যানেল রিপোর্টে বর্তমানে উপার্জন বা বিজ্ঞাপন সংক্রান্ত পারফর্ম্যান্স মেট্রিক অন্তর্ভুক্ত থাকে না। এর ফলে, https://www.googleapis.com/auth/yt-analytics-monetary.readonly স্কোপ বর্তমানে চ্যানেল রিপোর্টে আর্থিক ডেটা অ্যাক্সেস করার অনুমতি দেয় না।

    • operatingSystem ডাইমেনশনে তিনটি নতুন ডাইমেনশন ভ্যালু কাজ করে:
      • FIREFOX
      • REALMEDIA
      • TIZEN

৮ ফেব্রুয়ারি, ২০১৭

YouTube Analytics API এখন ঐচ্ছিক include-historical-channel-data প্যারামিটারকে সাপোর্ট করে। মনে রাখবেন, কন্টেন্টের মালিকের রিপোর্ট ফিরিয়ে আনার সময় এই প্যারামিটারটি প্রাসঙ্গিক।

এই প্যারামিটার কন্টেন্টের মালিককে এটি নির্দেশ করার অনুমতি দেয় যে API রেসপন্সে চ্যানেলের দেখার সময় এবং চ্যানেলটি কন্টেন্টের মালিকের সাথে লিঙ্ক করার আগের সময়সীমার ডেটা অন্তর্ভুক্ত করা উচিত। ডিফল্ট প্যারামিটারের মান হল false, যার অর্থ হল, ডিফল্ট হিসেবে, API রেসপন্সে শুধুমাত্র দেখার সময় এবং চ্যানেলগুলি কন্টেন্টের মালিকের সাথে লিঙ্ক করার সময় থেকে ডেটা অন্তর্ভুক্ত থাকে।

API অনুরোধ একাধিক চ্যানেলের জন্য ডেটা ফিরিয়ে আনলে, এই নিয়মগুলিও প্রযোজ্য হয়:

  • প্যারামিটারের মান false হলে, কোনও চ্যানেলের জন্য দেখানো দেখার সময় ও ভিউ সংক্রান্ত ডেটা সেই তারিখের উপর ভিত্তি করে দেখানো হয়, যে তারিখে চ্যানেলটি কন্টেন্টের মালিকের সাথে লিঙ্ক করা হয়েছিল।

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

১৫ ডিসেম্বর, ২০১৬

নিম্নলিখিত YouTube Reporting API রিপোর্ট আর কাজ করে না এবং ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। প্রতিটি রিপোর্টের নতুন ভার্সন উপলভ্য। (এইসব রিপোর্টের জন্য বন্ধ করে দেওয়ার ঘোষণা ১৫ সেপ্টেম্বর, ২০১৬-তে করা হয়েছিল।)

  • চ্যানেল রিপোর্ট

    • channel_basic_a1 - channel_basic_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • channel_province_a1 - channel_province_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • channel_playback_location_a1 - channel_playback_location_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • channel_traffic_source_a1 - channel_traffic_source_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • channel_device_os_a1 - channel_device_os_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • channel_subtitles_a1 - channel_subtitles_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • channel_combined_a1 - channel_combined_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।

  • কন্টেন্টের মালিকের রিপোর্ট

    • content_owner_basic_a2 - content_owner_basic_a3 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_province_a1 - content_owner_province_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_playback_location_a1 - content_owner_playback_location_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_traffic_source_a1 - content_owner_traffic_source_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_device_os_a1 - content_owner_device_os_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_subtitles_a1 - content_owner_subtitles_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_combined_a1 - content_owner_combined_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_basic_a1 - content_owner_asset_basic_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_province_a1 - content_owner_asset_province_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_playback_location_a1 - content_owner_asset_playback_location_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_traffic_source_a1 - content_owner_asset_traffic_source_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_device_os_a1 - content_owner_asset_device_os_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_combined_a1 - content_owner_asset_combined_a2 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।

API রেফারেন্স ডকুমেন্টেশনে বর্তমান রিপোর্টের ধরন-এর তালিকাও আপডেট করা হয়েছে।

১১ নভেম্বর, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

YouTube Reporting API তিনটি নতুন এন্ড স্ক্রিন রিপোর্ট এবং সেইসব রিপোর্টের জন্য নতুন ডাইমেনশন ও মেট্রিক্স সাপোর্ট করে। ভিডিও চলা বন্ধ হয়ে যাওয়ার পরে যে এন্ডস্ক্রিন দেখানো হয়, তার ইম্প্রেশন ও ক্লিক-থ্রু সংক্রান্ত পরিসংখ্যান এই রিপোর্টে দেখানো হয়।

  • এন্ড স্ক্রিন রিপোর্ট

    • চ্যানেলের ভিডিও-এর জন্য এন্ড স্ক্রিন রিপোর্টে চ্যানেলের সব ভিডিওর পরিসংখ্যান থাকে।
    • কন্টেন্ট মালিকের ভিডিও-এর জন্য এন্ডস্ক্রিন রিপোর্টে কন্টেন্ট মালিকের যেকোনও চ্যানেলের ভিডিওর পরিসংখ্যান থাকে।
    • কন্টেন্টের মালিকের অ্যাসেট সংক্রান্ত এন্ডস্ক্রিন রিপোর্টে, ভিডিওর সাথে যুক্ত অ্যাসেটের পরিসংখ্যান থাকে, যার পরে এন্ডস্ক্রিন দেখানো হয়।

  • এন্ড স্ক্রিনের ডাইমেনশন

    • end_screen_element_type: পরিসংখ্যানের সাথে যুক্ত এন্ডস্ক্রিন এলিমেন্টের ধরন।
    • end_screen_element_id: এন্ড স্ক্রিন এলিমেন্টকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।

  • এন্ডস্ক্রিন মেট্রিক

    মনে রাখবেন: এন্ডস্ক্রিন মেট্রিকের ডেটা ১ মে, ২০১৬ থেকে উপলভ্য।

    • end_screen_element_impressions: এন্ড স্ক্রিন এলিমেন্ট ইম্প্রেশনের মোট সংখ্যা। প্রতিটি এন্ডস্ক্রিন এলিমেন্ট দেখানোর জন্য একটি করে ইম্প্রেশন লগ করা হয়।
    • end_screen_element_clicks: এন্ডস্ক্রিন এলিমেন্টে যতবার ক্লিক করা হয়েছে।
    • end_screen_element_click_rate: এন্ড স্ক্রিন এলিমেন্টের ক্লিক-থ্রু রেট।

    • YouTube সহায়তা কেন্দ্রে আপনার ভিডিওতে এন্ড স্ক্রিন যোগ করা সম্পর্কে আরও বিস্তারিত তথ্য রয়েছে।

  • নিম্নলিখিত রিপোর্টগুলি আর কাজ করে না এবং ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। প্রতিটি রিপোর্টের নতুন ভার্সন উপলভ্য। (এইসব রিপোর্টের জন্য বন্ধ করে দেওয়ার ঘোষণা ২২ জুন, ২০১৬-এ করা হয়েছিল।)

    • content_owner_ad_performance_a1 - content_owner_ad_rates_a1 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_estimated_earnings_a1 - content_owner_estimated_revenue_a1 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।
    • content_owner_asset_estimated_earnings_a1 - content_owner_asset_estimated_revenue_a1 রিপোর্ট দিয়ে প্রতিস্থাপন করা হয়েছে।

৮ নভেম্বর, ২০১৬

এই আপডেটে YouTube Analytics API-তে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • নিম্নলিখিত তালিকার মেট্রিকগুলি সম্পূর্ণভাবে বন্ধ করা হয়েছে এবং আর কাজ করে না। ১০ আগস্ট, ২০১৬-তে ঘোষণা করা হয়েছে যে একই ডেটা রেফার করে এমন নতুন মেট্রিক আগে থেকেই কাজ করে। নিচের সারণীতে বন্ধ হয়ে যাওয়া মেট্রিকের নাম এবং নতুন মেট্রিকের নাম দেখানো হয়েছে:

    বন্ধ করা হয়েছে এমন মেট্রিক নতুন মেট্রিক
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

২৭ অক্টোবর, ২০১৬

YouTube এখন অটোমেটিক সিস্টেম-ম্যানেজড বিজ্ঞাপন থেকে উপার্জন সংক্রান্ত রিপোর্টের সেট তৈরি করে, যা কন্টেন্টের মালিকরা YouTube-এর Creator Studio-এর রিপোর্ট বিভাগে অ্যাক্সেস করতে পারেন। নতুন সিস্টেম-ম্যানেজড API রিপোর্ট এমনভাবে ডিজাইন করা হয়েছে যাতে ডেটার প্রোগ্রাম্যাটিক অ্যাক্সেস প্রদান করা যায়, যা ম্যানুয়ালি ডাউনলোড করা যায় এমন Creator Studio রিপোর্টেও উপলভ্য।

সিস্টেম-ম্যানেজড রিপোর্টের ওভারভিউ থেকে নতুন রিপোর্টের সংক্ষিপ্ত ওভারভিউ পাওয়া যায় এবং API-এর মাধ্যমে সেগুলি কীভাবে ফিরিয়ে আনা যায় সেই প্রসেস সম্পর্কে ব্যাখ্যা করা হয়। এই প্রসেসটি YouTube Analytics-এর জন্য বাল্ক রিপোর্ট ফিরিয়ে আনার প্রসেসের থেকে কিছুটা আলাদা কারণ পার্টনারদের রিপোর্ট তৈরি করার জন্য জব শিডিউল করতে হয় না।

reportType রিসোর্সের id প্রপার্টি আপডেট করা হয়েছে যাতে সিস্টেম-ম্যানেজ করা রিপোর্টের তালিকা অন্তর্ভুক্ত করা যায়, যা আপনি API-এর মাধ্যমে অ্যাক্সেস করতে পারবেন:

  • ভিডিও পিছু মাসিক, বিশ্বব্যাপী বিজ্ঞাপন থেকে উপার্জন
  • প্রতিটি ভিডিওর জন্য দৈনিক, দেশ-ভিত্তিক বিজ্ঞাপন থেকে উপার্জন
  • অ্যাসেট প্রতি মাসিক, বিশ্বব্যাপী বিজ্ঞাপন থেকে উপার্জন
  • প্রতিটি অ্যাসেটের জন্য দেশ অনুযায়ী দৈনিক বিজ্ঞাপন থেকে উপার্জন
  • দাবি (এই রিপোর্টে উপার্জন সংক্রান্ত ডেটা নেই)

২৭ সেপ্টেম্বর, ২০১৬

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

YouTube Analytics API-এর uniques মেট্রিক অননুমোদিত হয়েছে৷ এটি কোনও মূল মেট্রিক নয় এবং এটি ৩১ অক্টোবর, ২০১৬ পর্যন্ত কাজ করবে।

১৫ সেপ্টেম্বর, ২০১৬

এই আপডেটে YouTube Reporting API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • API-তে YouTube Red দর্শকসংখ্যা সম্পর্কিত দুটি নতুন মেট্রিক আছে:

    • red_views: YouTube Red মেম্বাররা যতবার ভিডিওটি দেখেছেন।
    • red_watch_time_minutes: YouTube Red মেম্বাররা যত মিনিট ধরে কোনও ভিডিও দেখেছেন।

  • API-তে ২০টি রিপোর্টের নতুন ভার্সন কাজ করে। সব নতুন ভার্সনে নতুন red_views ও red_watch_time_minutes মেট্রিক কাজ করে।

    প্রতিটি রিপোর্টের ক্ষেত্রে, নতুন রিপোর্ট টাইপ আইডিতে থাকা নম্বরটি পুরনো রিপোর্ট টাইপ আইডিতে থাকা নম্বরের থেকে এক নম্বর বেশি। (এই রিপোর্টের পুরনো ভার্সন এখন বন্ধ করে দেওয়া হয়েছে, যেমনটি এই রিভিশন ইতিহাসে পরে বর্ণনা করা হয়েছে।) যেমন, channel_basic_a1 রিপোর্ট এখন বন্ধ করে দেওয়া হয়েছে এবং তার পরিবর্তে channel_basic_a2 রিপোর্ট চালু করা হয়েছে।

    নিম্নলিখিত তালিকা নতুন রিপোর্ট টাইপ আইডি শনাক্ত করে:

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    মনে রাখবেন, উপরে তালিকাভুক্ত রিপোর্টের কোনও পুরনো ভার্সন তৈরি করার জন্য আপনার কাছে আগে থেকেই কোনও কাজ থাকলে, নাম পরিবর্তন করা রিপোর্টের জন্য আপনাকে নতুন কাজ তৈরি করতে হবে। নতুন রিপোর্টের ভার্সন রিলিজ হওয়ার সাথে সাথে নিম্নলিখিত রিপোর্টের ভার্সন বন্ধ করে দেওয়া হয়েছে:

    • channel_basic_a1
    • channel_province_a1
    • channel_playback_location_a1
    • channel_traffic_source_a1
    • channel_device_os_a1
    • channel_subtitles_a1
    • channel_combined_a1
    • content_owner_basic_a2
    • content_owner_province_a1
    • content_owner_playback_location_a1
    • content_owner_traffic_source_a1
    • content_owner_device_os_a1
    • content_owner_subtitles_a1
    • content_owner_combined_a1
    • content_owner_asset_basic_a1
    • content_owner_asset_province_a1
    • content_owner_asset_playback_location_a1
    • content_owner_asset_traffic_source_a1
    • content_owner_asset_device_os_a1
    • content_owner_asset_combined_a1

    এইসব রিপোর্টের কোনওটির জন্য আপনার কাছে জব থাকলে, ১৫ ডিসেম্বর, ২০১৬-এর পরে সেইসব জবের জন্য YouTube নতুন রিপোর্ট তৈরি করবে বলে আশা করবেন না। জেনারেট করা রিপোর্ট, জেনারেট হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য থাকবে।

১৯ আগস্ট, ২০১৬

এই আপডেটে YouTube Reporting API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • content_owner_basic_a1 রিপোর্ট সম্পূর্ণভাবে বন্ধ করে দেওয়া হয়েছে এবং ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। YouTube আর সেই ধরনের নতুন রিপোর্ট তৈরি করবে না, তবে আগে থেকে তৈরি করা রিপোর্টগুলি তৈরি হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য থাকবে।

    content_owner_basic_a1 রিপোর্টের পরিবর্তে content_owner_basic_a2 রিপোর্ট ব্যবহার করা হয়, যেমনটি ১৯ মে, ২০১৬-এর রিভিশন ইতিহাস এন্ট্রিতে ব্যাখ্যা করা হয়েছে।

১১ আগস্ট, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • নতুন প্রকাশিত YouTube API পরিষেবার শর্তাবলী ("আপডেট করা শর্তাবলী"), YouTube ইঞ্জিনিয়ারিং ও ডেভেলপার ব্লগে বিস্তারিতভাবে আলোচনা করা হয়েছে, যা বর্তমান পরিষেবার শর্তাবলীতে অনেক আপডেট প্রদান করে। আপডেট করা শর্তাবলীর পাশাপাশি, যা ১০ ফেব্রুয়ারি, ২০১৭ থেকে কার্যকর হবে, এই আপডেটে বেশ কয়েকটি সহায়ক ডকুমেন্ট অন্তর্ভুক্ত রয়েছে যা ডেভেলপারদের অবশ্যই অনুসরণ করতে হবে এমন নীতিগুলি ব্যাখ্যা করতে সাহায্য করবে।

    নতুন ডকুমেন্টের সম্পূর্ণ সেট আপডেট করা শর্তাবলীর জন্য রিভিশন ইতিহাসতে বর্ণনা করা হয়েছে। এছাড়াও, আপডেট করা শর্তাবলী বা সেইসব সহায়ক ডকুমেন্টে ভবিষ্যতে কোনও পরিবর্তন করা হলে, তা এই সংশোধনের ইতিহাসে ব্যাখ্যা করা হবে।

১০ আগস্ট, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • YouTube Analytics API (টার্গেট করা কোয়েরি)

    • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

      নিম্নলিখিত সারণীতে দেখানো মেট্রিকগুলি বন্ধ করা হচ্ছে। একই সময়ে, একই ডেটা রেফার করে এমন নতুন মেট্রিক চালু করা হচ্ছে। এর অর্থ হল, পুরনো মেট্রিকের নাম পরিবর্তন করা হচ্ছে, যদিও YouTube Analytics API, সারণীতে তালিকাভুক্ত বন্ধ করার তারিখ পর্যন্ত দুটি মেট্রিকের নামই সাপোর্ট করবে।

      পুরনো মেট্রিকের নাম নতুন মেট্রিকের নাম সহায়তার তারিখ
      earnings estimatedRevenue ১০ আগস্ট, ২০১৭
      adEarnings estimatedAdRevenue ৪ নভেম্বর, ২০১৬
      redPartnerRevenue estimatedRedPartnerRevenue ৪ নভেম্বর, ২০১৬
      impressionBasedCpm cpm ৪ নভেম্বর, ২০১৬
      impressions adImpressions ৪ নভেম্বর, ২০১৬

      মনে রাখবেন যে earnings মেট্রিকটি একটি কোর মেট্রিক ছিল, তাই এই ঘোষণার তারিখ থেকে এক বছরের জন্য এটি কাজ করবে। অন্যান্য মেট্রিক, যা মূল মেট্রিক ছিল না, তা তিন মাস, ৪ নভেম্বর, ২০১৬ পর্যন্ত কাজ করবে।

      যেমন, ৪ নভেম্বর, ২০১৬ পর্যন্ত, API অনুরোধে impressionBasedCpm মেট্রিক, cpm মেট্রিক বা দুটিই উল্লেখ করা যেতে পারে। তবে, সেই তারিখের পরে, শুধুমাত্র cpm মেট্রিক কাজ করবে।

    • insightTrafficSourceType ডাইমেনশন দুটি নতুন ডাইমেনশন ভ্যালু সাপোর্ট করে:
      • CAMPAIGN_CARD: এই ট্রাফিক সোর্স শুধুমাত্র কন্টেন্টের মালিকের রিপোর্ট-এর জন্য কাজ করে। এটি ইঙ্গিত করে যে ভিউগুলি দাবি করা, ব্যবহারকারীর আপলোড করা ভিডিও থেকে এসেছে যা কন্টেন্টের মালিক ভিউ করা কন্টেন্ট প্রচার করতে ব্যবহার করেছেন।
      • END_SCREEN: অন্য ভিডিওর এন্ডস্ক্রিন থেকে আসা ভিউয়ের ডেটা।

      দুটি নতুন ট্রাফিক সোর্সের জন্য, আপনি একটি traffic source detail রিপোর্টও পেতে পারেন। উভয় ক্ষেত্রেই, insightTrafficSourceDetail ডাইমেনশন সেই ভিডিওকে শনাক্ত করে যেখান থেকে দর্শককে রেফার করা হয়েছে।

    • adType ডাইমেনশন এখন auctionBumperInstream ভ্যালু সাপোর্ট করে, যা সর্বাধিক ৬ সেকেন্ডের স্কিপ করার সুবিধা না থাকা ভিডিও বিজ্ঞাপনকে বোঝায় এবং কোনও ভিডিও দেখার আগে এটি দেখানো হয়।

  • YouTube Reporting API (বাল্ক রিপোর্ট)

    • traffic_source_type ডাইমেনশন এখন নিম্নলিখিত ভ্যালু সাপোর্ট করে:
      • 19: এই ট্রাফিক সোর্স শুধুমাত্র কন্টেন্টের মালিকের রিপোর্ট-এর জন্য কাজ করে। এটি ইঙ্গিত করে যে ভিউগুলি দাবি করা, ব্যবহারকারীর আপলোড করা ভিডিও থেকে এসেছে যা কন্টেন্টের মালিক ভিউ করা কন্টেন্ট প্রচার করতে ব্যবহার করেছেন।
      • 20: অন্য ভিডিওর এন্ডস্ক্রিন থেকে আসা ভিউয়ের ডেটা।

      দুটি নতুন ট্রাফিক সোর্সের জন্যই, traffic_source_detail ডাইমেনশন সেই ভিডিওকে শনাক্ত করে যেখান থেকে দর্শককে রেফার করা হয়েছে।

    • API-এর মূল মেট্রিকের তালিকায় estimated_partner_revenue-কে মূল মেট্রিক হিসেবে যোগ করা হয়েছে এবং earnings-কে সেই তালিকা থেকে সরানো হয়েছে। (YouTube Reporting API-তে earnings মেট্রিক কখনও কাজ করেনি।)

    • ad_type ডাইমেনশনে এখন 19 ভ্যালু কাজ করে যা বাম্পার বিজ্ঞাপনকে বোঝায়। এটি হল স্কিপ করার সুবিধা না থাকা ভিডিও বিজ্ঞাপন যা সর্বাধিক ৬ সেকেন্ডের হয় এবং কোনও ভিডিও দেখার আগে দেখানো হয়।

১৮ জুলাই, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • YouTube Analytics API (টার্গেট করা কোয়েরি)

    • কার্ড মেট্রিক্স অন্তর্ভুক্ত করার জন্য নিম্নলিখিত চ্যানেল রিপোর্টের জন্য কাজ করে এমন মেট্রিক্সের তালিকা আপডেট করা হয়েছে। এইসব রিপোর্টে কার্ড মেট্রিকের জন্য সহায়তা আসলে ২৮ জুন, ২০১৬-এ যোগ করা হয়েছিল এবং সেই তারিখের জন্য রিভিশন ইতিহাসের এন্ট্রি আরও বিস্তারিতভাবে পরিবর্তনটি ব্যাখ্যা করে। রিপোর্টগুলি হল:
      • মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির জন্য ব্যবহারকারীর প্রাথমিক অ্যাক্টিভিটি
      • নির্দিষ্ট সময়সীমার জন্য মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলিতে ব্যবহারকারীর অ্যাক্টিভিটি
      • প্রদেশ অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি
      • সাবস্ক্রিপশন স্ট্যাটাস অনুযায়ী ব্যবহারকারীর অ্যাক্টিভিটি
      • প্রদেশ অনুযায়ী সাবস্ক্রিপশন স্ট্যাটাস অনুসারে ব্যবহারকারীর অ্যাক্টিভিটি
      • রাজ্য অনুযায়ী সেরা ভিডিও
      • সাবস্ক্রাইব করা বা আনসাবস্ক্রাইব করা দর্শকদের জন্য সেরা ভিডিও

    • চ্যানেলের দর্শক ধরে রাখার রিপোর্ট এবং কন্টেন্টের মালিকের দর্শক ধরে রাখার রিপোর্ট, দুটির ক্ষেত্রেই ফিল্টারের তালিকা সংশোধন করা হয়েছে যাতে বোঝা যায় যে video ফিল্টার প্রয়োজন এবং group ফিল্টার কাজ করে না।

      আগে, দুটি রিপোর্টের ডকুমেন্টেশনে ভুলভাবে বলা হয়েছিল যে রিপোর্টটি সেই দুটি ফিল্টারের একটি ব্যবহার করে বা কোনও ফিল্টার ব্যবহার না করে ফিরিয়ে আনা যেতে পারে।

  • YouTube Reporting API (বাল্ক রিপোর্ট)

    • API ওভারভিউ-এ, যে বিভাগে কোনও রিপোর্টের ডাউনলোড URL কীভাবে ফিরিয়ে আনা যায় তা ব্যাখ্যা করা হয়েছে, সেখানে সংশোধন করে বলা হয়েছে যে YouTube এমন দিনের জন্য ডাউনলোডযোগ্য রিপোর্ট তৈরি করে যে দিন কোনও ডেটা উপলভ্য ছিল না। এইসব রিপোর্টে হেডার রো থাকে, তবে অতিরিক্ত ডেটা থাকে না। এই তথ্যটি আগেই ১২ এপ্রিল, ২০১৬ তারিখে একই ডকুমেন্টের রিপোর্টের বৈশিষ্ট্য বিভাগে আপডেট করা হয়েছে।
    • content_owner_asset_cards_a1 রিপোর্টে ডাইমেনশনের তালিকা সংশোধন করা হয়েছে যাতে বোঝা যায় যে রিপোর্টে card_id ডাইমেনশন ব্যবহার করা হয়েছে। আগে, ডকুমেন্টেশনে ভুল করে ডাইমেনশনের নাম card_title হিসেবে তালিকাভুক্ত করা হয়েছিল।

২৮ জুন, ২০১৬

YouTube Analytics API ডকুমেন্টেশন আপডেট করা হয়েছে যাতে অসংখ্য চ্যানেল এবং কন্টেন্টের মালিক সংক্রান্ত রিপোর্টে কার্ড মেট্রিক-এর জন্য সহায়তা প্রতিফলিত হয়। নতুন কাজ করা মেট্রিকগুলি হল:

নিম্নলিখিত ধরনের রিপোর্টে মেট্রিক কাজ করে:

২২ জুন, ২০১৬

এই আপডেটে YouTube Reporting API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে। প্রথম পরিবর্তনটি সাধারণভাবে API-এর সাথে সম্পর্কিত এবং বাকি পরিবর্তনগুলি শুধুমাত্র কন্টেন্টের মালিকের রিপোর্টকে প্রভাবিত করে:

  • API ওভারভিউয়ের রিপোর্টের বৈশিষ্ট্য বিভাগটি আপডেট করা হয়েছে যাতে এটি স্পষ্ট হয় যে রিপোর্টগুলি তৈরি হওয়ার সময় থেকে ১৮০ দিনের জন্য API-এর মাধ্যমে উপলভ্য থাকে।

    আগে, ডকুমেন্টেশনে উল্লেখ করা হয়েছিল যে API অনুরোধ পাঠানোর তারিখের আগে ১৮০ দিন পর্যন্ত রিপোর্টের ডেটা উপলভ্য থাকে। যদিও টেকনিক্যালি এটিও সঠিক, তবে আসল টেক্সটটি, খুব বেশি হলে, বিভ্রান্তিকর ছিল।

  • API তিনটি রিপোর্টের নতুন ভার্সন সাপোর্ট করে। এইসব রিপোর্টের মধ্যে দুটিতে নতুন ও নাম পরিবর্তন করা মেট্রিকও রয়েছে:

    • content_owner_ad_rates_a1 রিপোর্ট হল content_owner_ad_performance_a1 রিপোর্টের নতুন ভার্সন। নতুন নাম দেওয়া রিপোর্টটি আগের ভার্সনের মতোই।

    • নতুন ভার্সন আছে এমন দুটি রিপোর্টের নাম পরিবর্তন করা হয়েছে:

      • content_owner_estimated_earnings_a1 রিপোর্টের নতুন ভার্সনের নাম হল content_owner_estimated_revenue_a1।
      • content_owner_asset_estimated_earnings_a1 রিপোর্টের নতুন ভার্সনের নাম হল content_owner_asset_estimated_revenue_a1।

      নতুন নাম দেওয়া দুটি রিপোর্টই নিম্নলিখিত উপায়ে তাদের পূর্বসূরিদের থেকে আলাদা:

      • তারা নতুন estimated_partner_red_revenue মেট্রিক যোগ করে, যা YouTube Red সাবস্ক্রিপশন থেকে মোট উপার্জন অনুমান করে।
      • তারা নতুন estimated_partner_transaction_revenue মেট্রিক যোগ করে, যা ট্রানজ্যাকশন থেকে হওয়া আনুমানিক উপার্জন দেখায়, যেমন পেড কন্টেন্ট এবং ফ্যান ফান্ডিং, পার্টনারের চার্জ করা রিফান্ড বাদ দিয়ে।
      • তারা estimated_partner_ad_sense_revenue মেট্রিকের নাম পরিবর্তন করে estimated_partner_ad_auction_revenue করে।
      • তারা estimated_partner_double_click_revenue মেট্রিকের নাম পরিবর্তন করে estimated_partner_ad_reserved_revenue করে।

    মনে রাখবেন, এইসব রিপোর্টের পুরনো ভার্সন তৈরি করার জন্য আপনার কাছে আগে থেকেই কোনও কাজ থাকলে, নাম পরিবর্তন করা রিপোর্টের জন্য আপনাকে নতুন কাজ তৈরি করতে হবে। রিপোর্টের নতুন ভার্সন রিলিজ করার সাথে সাথে content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 ও content_owner_asset_estimated_earnings_a1 রিপোর্ট বন্ধ করে দেওয়া হয়েছে।

    এইসব রিপোর্টের কোনওটির জন্য আপনার কাছে কাজ থাকলে, ২২ সেপ্টেম্বর, ২০১৬-এর পরে সেইসব কাজের জন্য YouTube নতুন রিপোর্ট তৈরি করবে বলে আশা করবেন না। জেনারেট করা রিপোর্ট, জেনারেট হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য থাকবে।

  • reportType রিসোর্সের id প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে উপলভ্য রিপোর্টের বর্তমান সেট দেখানো যায়।

  • রিপোর্টে দেখানো নামের সাথে মিল রাখার জন্য ডকুমেন্টেশনে দুটি মেট্রিকের নাম সংশোধন করা হয়েছে। এটি শুধুমাত্র ডকুমেন্টেশন সংক্রান্ত সমস্যার সমাধান এবং আসল রিপোর্টের কন্টেন্টে কোনও পরিবর্তন করা হয়নি:

    • estimated_partner_adsense_revenue মেট্রিকের নাম আপডেট করে estimated_partner_ad_sense_revenue করা হয়েছে। তবে মনে রাখবেন, এই মেট্রিকটি শুধুমাত্র দুটি রিপোর্টে দেখা যায় যা এই আপডেটের সাথে বন্ধ করা হচ্ছে। উপরে যেমন বর্ণনা করা হয়েছে, সেইসব রিপোর্টের নতুন ভার্সনে এই মেট্রিকের নাম পরিবর্তন করে estimated_partner_ad_auction_revenue করা হয়েছে।
    • estimated_partner_doubleclick_revenue মেট্রিকের নাম আপডেট করে estimated_partner_double_click_revenue করা হয়েছে। আবার, মনে রাখবেন যে এই মেট্রিক শুধুমাত্র দুটি রিপোর্টে দেখা যায় যা এই আপডেটের সাথে বন্ধ করা হচ্ছে। উপরে যেমন বর্ণনা করা হয়েছে, সেইসব রিপোর্টের নতুন ভার্সনে এই মেট্রিকের নাম পরিবর্তন করে estimated_partner_ad_reserved_revenue করা হয়েছে।

  • Reporting API-এর জন্য ডাইমেনশন ডকুমেন্টেশন আপডেট করা হয়েছে যাতে elapsed_video_time_percentage এবং audience_retention_type প্রপার্টি আর তালিকাভুক্ত না হয়। API-এর মাধ্যমে উপলভ্য কোনও রিপোর্টে বর্তমানে এইসব ডাইমেনশন কাজ করে না।

১৯ মে, ২০১৬

এই আপডেটে YouTube Reporting API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • API, কন্টেন্টের মালিকদের জন্য ব্যবহারকারীর অ্যাক্টিভিটি রিপোর্টের নতুন ভার্সন সাপোর্ট করে। নতুন রিপোর্টের জন্য রিপোর্ট টাইপ আইডি হল content_owner_basic_a2। রিপোর্টের আগের ভার্সন, content_owner_basic_a1-এর থেকে আলাদা, নতুন ভার্সনে likes এবং dislikes মেট্রিক কাজ করে।

    content_owner_basic_a1 রিপোর্ট তৈরি করার জন্য আপনার কাছে আগে থেকেই কোনও কাজ থাকলে, content_owner_basic_a2 রিপোর্টের জন্য আপনাকে এখনও একটি নতুন কাজ তৈরি করতে হবে। YouTube অটোমেটিক কন্টেন্টের মালিকদের নতুন রিপোর্ট ভার্সনে মাইগ্রেট করছে না বা নতুন রিপোর্ট ভার্সন তৈরি করার জন্য অটোমেটিক কোনও কাজ তৈরি করছে না। কিছু ক্ষেত্রে, নতুন, অপ্রত্যাশিত জব দেখা গেলে তা ব্রেকিং পরিবর্তন হতে পারে।

    নতুন রিপোর্ট রিলিজ করার সাথে সাথে content_owner_basic_a1 রিপোর্ট বন্ধ করে দেওয়া হয়েছে। সেই রিপোর্টের জন্য আপনার কোনও কাজ থাকলে, ১৯ আগস্ট, ২০১৬-এর পরে সেই কাজের জন্য YouTube নতুন রিপোর্ট তৈরি করবে বলে আশা করবেন না। জেনারেট করা রিপোর্ট, জেনারেট হওয়ার সময় থেকে ১৮০ দিন পর্যন্ত উপলভ্য থাকবে।

  • reportType, job এবং report রিসোর্সগুলি একটি নতুন প্রপার্টিকে সমর্থন করে যা শনাক্ত করে যে সংশ্লিষ্ট রিসোর্সটি একটি বন্ধ হয়ে যাওয়া রিপোর্টের ধরনকে উপস্থাপন করে কিনা:

    • reportType রিসোর্সের deprecateTime প্রপার্টি সেই তারিখ ও সময় নির্দিষ্ট করে যখন রিপোর্টের ধরন বন্ধ করা হবে। এই প্রপার্টিতে শুধুমাত্র সেইসব রিপোর্টের জন্য ভ্যালু থাকে যেগুলি বন্ধ করে দেওয়া হয়েছে বলে ঘোষণা করা হয়েছে এবং ভ্যালু সেই তারিখকে দেখায় যখন YouTube এই ধরনের রিপোর্ট তৈরি করা বন্ধ করে দেবে।

      কোনও রিপোর্টের ধরন বাতিল বলে ঘোষণা করার পরে, YouTube আরও তিন মাস সেই ধরনের রিপোর্ট তৈরি করে। যেমন, ১৯ মে, ২০১৬-এর এই আপডেট content_owner_basic_a1 রিপোর্ট বন্ধ করার ঘোষণা করে। তাই, সেই ধরনের রিপোর্টের জন্য deprecateTime ১৯ আগস্ট, ২০১৬-এর একটি সময় নির্দিষ্ট করে, যার পরে YouTube সেই ধরনের রিপোর্ট তৈরি করা বন্ধ করে দেবে।

    • job রিসোর্সের expireTime প্রপার্টি সেই তারিখ ও সময় নির্দিষ্ট করে যখন জবটির মেয়াদ শেষ হয়ে গেছে বা যাবে। জবের সাথে সম্পর্কিত রিপোর্টের ধরন বাতিল করা হলে অথবা জবের জন্য তৈরি করা রিপোর্ট দীর্ঘ সময় ধরে ডাউনলোড করা না হলে, এই প্রপার্টির একটি ভ্যালু থাকে। এই তারিখটি সেই সময়কে চিহ্নিত করে যার পরে YouTube আর কাজের জন্য নতুন রিপোর্ট তৈরি করে না।

    • report রিসোর্সের jobExpireTime প্রপার্টি সেই তারিখ ও সময় নির্দিষ্ট করে যখন রিপোর্টের সাথে যুক্ত কাজ হয় শেষ হয়ে গেছে অথবা শেষ হয়ে যাবে। এই প্রপার্টিতে job রিসোর্সের expireTime প্রপার্টির মতো একই ভ্যালু থাকে, যেমনটি এই তালিকার আগের আইটেমে বর্ণনা করা হয়েছে।

  • আপনি যদি কোনও বন্ধ হয়ে যাওয়া রিপোর্টের জন্য জব তৈরি করার চেষ্টা করেন, তাহলে jobs.create পদ্ধতি এখন একটি 400 HTTP রেসপন্স কোড (Bad Request) রিটার্ন করে। এছাড়াও, পদ্ধতির ডকুমেন্টেশনে এখন আরও কয়েকটি কারণের তালিকা রয়েছে যার কারণে API অনুরোধ ব্যর্থ হয়।

১২ এপ্রিল, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে, যার সবকটিই শুধুমাত্র YouTube Reporting API-কে প্রভাবিত করে:

  • YouTube এখন রিপোর্টিংয়ের কাজ প্রথমবার শিডিউল করার ১৮০ দিন আগে পর্যন্ত ডেটা জেনারেট করে। আগে, রিপোর্টিং API কোনও ঐতিহাসিক ডেটা প্রদান করত না। এই পরিবর্তন সব কাজের উপর প্রভাব ফেলে, যার মধ্যে এই ঘোষণার আগে তৈরি করা কাজও অন্তর্ভুক্ত।

    পুরনো রিপোর্ট উপলভ্য হওয়ার সাথে সাথেই পোস্ট করা হয়, যদিও কোনও কাজের জন্য সমস্ত পুরনো ডেটা পোস্ট করতে প্রায় এক মাস সময় লাগে। তাই, রিপোর্টিং জব শিডিউল করার এক মাস পরে, আপনার কাছে প্রায় সাত মাসের ডেটার অ্যাক্সেস থাকবে। (এই ঘোষণার আগে তৈরি করা চাকরির সমস্ত ঐতিহাসিক ডেটা ঘোষণার এক মাসের মধ্যে পোস্ট করা উচিত।)

    মনে রাখবেন, ১ জুলাই, ২০১৫ থেকে পুরনো ডেটা উপলভ্য। এর ফলে, ২৮ ডিসেম্বর, ২০১৫-এর আগে তৈরি করা কাজের ক্ষেত্রে ১৮০ দিনের কম সময়ের পুরনো ডেটা থাকবে।

    এইসব পরিবর্তন রিপোর্টিং API ওভারভিউয়ের নতুন ঐতিহাসিক ডেটা বিভাগে ব্যাখ্যা করা হয়েছে।

  • YouTube Reporting API ওভারভিউয়ের রিপোর্ট সংক্রান্ত বৈশিষ্ট্য বিভাগে নিম্নলিখিত পরিবর্তন করা হয়েছে:

    • ডকুমেন্টেশনে এখন উল্লেখ করা আছে যে রিপোর্ট জেনারেট হওয়ার পর ১৮০ দিন পর্যন্ত উপলভ্য থাকে এবং তাই API ক্লায়েন্টরা তা ডাউনলোড করতে পারবেন। আগে, ডকুমেন্টেশনে বলা হয়েছিল যে API অনুরোধ পাঠানোর তারিখের আগে সর্বাধিক ছয় মাসের সময়সীমার জন্য রিপোর্ট উপলভ্য ছিল।

    • ডকুমেন্টেশন আপডেট করা হয়েছে যাতে এটি বোঝা যায় যে API এখন সেইসব দিনের জন্য ডাউনলোডযোগ্য রিপোর্ট তৈরি করে, যে দিনগুলিতে কোনও ডেটা উপলভ্য ছিল না। এইসব রিপোর্টে হেডার সারি থাকবে, তবে অতিরিক্ত ডেটা থাকবে না।

  • YouTube Reporting API শীঘ্রই অটোমেটিক তৈরি হওয়া, সিস্টেম-ম্যানেজ করা রিপোর্টের সেটকে সাপোর্ট করবে, যাতে বিজ্ঞাপন থেকে উপার্জন বা YouTube Red সাবস্ক্রিপশন থেকে উপার্জনের ডেটা থাকবে। যেসব কন্টেন্টের মালিক YouTube Creator Studio থেকে ম্যানুয়ালি ডাউনলোড করা যায় এমন উপার্জনের রিপোর্ট অ্যাক্সেস করতে পারেন, তারা এই রিপোর্টও অ্যাক্সেস করতে পারবেন। তাই, নতুন API কার্যকারিতা সেই ডেটাতে প্রোগ্র্যামাটিক অ্যাক্সেস প্রদান করবে।

    সিস্টেম-ম্যানেজড রিপোর্ট লঞ্চ করার প্রস্তুতি হিসেবে নিম্নলিখিত API পরিবর্তনগুলি এখন ঘোষণা করা হচ্ছে:

    • job রিসোর্সের নতুন systemManaged প্রপার্টি থেকে বোঝা যায় যে রিসোর্সটি এমন কোনও কাজের বর্ণনা দেয় কিনা যা সিস্টেম-ম্যানেজড রিপোর্ট তৈরি করে। YouTube কন্টেন্টের মালিকদের জন্য YouTube অটোমেটিক সিস্টেম-ম্যানেজড রিপোর্ট তৈরি করে এবং কন্টেন্টের মালিকরা সেইসব রিপোর্ট তৈরি করা কাজগুলি পরিবর্তন করতে বা মুছে ফেলতে পারবেন না।

    • jobs.list পদ্ধতির নতুন includeSystemManaged প্যারামিটার নির্দেশ করে যে API রেসপন্সে সিস্টেম-ম্যানেজ করা রিপোর্টের জন্য কাজ অন্তর্ভুক্ত করা উচিত কিনা। প্যারামিটারের ডিফল্ট ভ্যালু হল false।

    • jobs.reports.list পদ্ধতির নতুন startTimeAtOrAfter প্যারামিটার থেকে বোঝা যায় যে রিপোর্টে সবচেয়ে পুরনো ডেটা নির্দিষ্ট তারিখ বা তার পরে হলে তবেই API রেসপন্সে রিপোর্ট থাকবে। একইভাবে, startTimeBefore প্যারামিটার থেকে বোঝা যায় যে রিপোর্টের সবচেয়ে পুরনো ডেটা নির্দিষ্ট তারিখের আগে হলে তবেই API রেসপন্সে রিপোর্ট থাকবে।

      মেথডের createdAfter প্যারামিটারের মতো নয়, যা রিপোর্ট তৈরি করার সময়ের সাথে সম্পর্কিত, নতুন প্যারামিটারগুলি রিপোর্টের ডেটার সাথে সম্পর্কিত।

    • reportType রিসোর্সের নতুন systemManaged প্রপার্টি থেকে বোঝা যায় যে রিসোর্সটি সিস্টেম-ম্যানেজড রিপোর্ট বর্ণনা করে কিনা।

    • reportTypes.list পদ্ধতির নতুন includeSystemManaged প্যারামিটার থেকে বোঝা যায় যে API রেসপন্সে সিস্টেম-ম্যানেজড রিপোর্ট অন্তর্ভুক্ত করা উচিত কিনা। প্যারামিটারের ডিফল্ট ভ্যালু হল false।

২৮ মার্চ, ২০১৬

YouTube Reporting API এবং YouTube Analytics API এখন আরও কয়েকটি শেয়ারিং পরিষেবার জন্য ভিউ সংক্রান্ত পরিসংখ্যান দেখায়।

  • YouTube Reporting API-তে, sharing_service ডাইমেনশন এইসব নতুন ভ্যালুর সাথে কাজ করে:
    • 82: iOS সিস্টেম অ্যাক্টিভিটি ডায়ালগ
    • 83: Google Inbox
    • 84: Android Messenger
  • YouTube Analytics API-তে, sharingService ডাইমেনশন এইসব নতুন ভ্যালুর সাথে কাজ করে:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: iOS সিস্টেম অ্যাক্টিভিটি ডায়ালগ

১৬ মার্চ, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে, যা YouTube Reporting API এবং YouTube Analytics API, দুটির উপরেই প্রভাব ফেলে:

YouTube Reporting API

  • playback_location_type ডাইমেনশন দুটি নতুন ডাইমেনশন ভ্যালু সাপোর্ট করে:
    • 7: YouTube হোম পেজ বা হোম স্ক্রিন, ব্যবহারকারীর সাবস্ক্রিপশন ফিড বা অন্য কোনও YouTube ব্রাউজিং ফিচারে হওয়া ভিউয়ের সাথে এই ডেটা সম্পর্কিত।
    • 8: এই ডেটা সরাসরি YouTube সার্চ ফলাফল পৃষ্ঠায় হওয়া ভিউয়ের সাথে সম্পর্কিত।
  • traffic_source_type ডাইমেনশন এখন ডাইমেনশন ভ্যালু হিসেবে 18-কে সাপোর্ট করে। এই ভ্যালু থেকে বোঝা যায় যে ভিডিও ভিউ এমন একটি পৃষ্ঠা থেকে এসেছে যেখানে প্লেলিস্টের সব ভিডিওর তালিকা রয়েছে। এই সোর্সটি 14 সোর্সের ধরন থেকে আলাদা, যা ইঙ্গিত করে যে ভিডিওটি প্লেলিস্টের অংশ হিসেবে চালানোর সময় ভিউ হয়েছে।

YouTube Analytics API

  • insightPlaybackLocationType ডাইমেনশন দুটি নতুন ডাইমেনশন ভ্যালু সাপোর্ট করে:
    • BROWSE: YouTube হোম পেজ বা হোম স্ক্রিন, ব্যবহারকারীর সাবস্ক্রিপশন ফিড বা অন্য কোনও YouTube ব্রাউজিং ফিচারে হওয়া ভিউয়ের সাথে এই ডেটা সম্পর্কিত।
    • SEARCH: এই ডেটা সরাসরি YouTube সার্চ ফলাফল পৃষ্ঠায় হওয়া ভিউয়ের সাথে সম্পর্কিত।
  • insightTrafficSourceType ডাইমেনশন এখন ডাইমেনশন ভ্যালু হিসেবে YT_PLAYLIST_PAGE-কে সাপোর্ট করে। এই ভ্যালু থেকে বোঝা যায় যে ভিডিও ভিউ এমন একটি পৃষ্ঠা থেকে এসেছে যেখানে প্লেলিস্টের সব ভিডিওর তালিকা রয়েছে। এই সোর্সটি PLAYLIST সোর্সের ধরন থেকে আলাদা, যা ইঙ্গিত করে যে ভিডিওটি প্লেলিস্টের অংশ হিসেবে চালানোর সময় ভিউ হয়েছে।

৮ ফেব্রুয়ারি, ২০১৬

YouTube Analytics API-এর জন্য কাজ করে এমন মেট্রিকের তালিকা আপডেট করা হয়েছে যাতে কার্ড মেট্রিক আর সেই API-এর জন্য কাজ করে এমন মেট্রিক হিসেবে তালিকাভুক্ত না হয়। (সেই API-এর কোনও রিপোর্টই কার্ড মেট্রিক্সের কোনওটিকে সমর্থন করার জন্য ডকুমেন্ট করা হয়নি।)

মনে রাখবেন, আপনি এখনও YouTube Reporting API ব্যবহার করে কার্ড মেট্রিক ফিরিয়ে আনতে পারবেন, যা অসংখ্য চ্যানেল এবং কন্টেন্টের মালিক সংক্রান্ত রিপোর্টের জন্য সেইসব মেট্রিককে সাপোর্ট করে।

৬ জানুয়ারি, ২০১৬

YouTube Reporting API এবং YouTube Analytics API, দুটিই এখন Chromecast ডিভাইসের মাধ্যমে হওয়া ভিউকে নির্দিষ্টভাবে শনাক্ত করে।

  • YouTube Reporting API-তে, Chromecast-এর মাধ্যমে হওয়া ভিউ শনাক্ত করতে operating_system ডাইমেনশন 21 ভ্যালু ব্যবহার করে।
  • YouTube Analytics API-তে, operatingSystem ডাইমেনশন CHROMECAST ভ্যালু ব্যবহার করে Chromecast-এর মাধ্যমে হওয়া ভিউ শনাক্ত করে।

২১ ডিসেম্বর, ২০১৫

ডকুমেন্টেশনে, annotation_clickable_impressions এবং annotation_closable_impressions মেট্রিকের নাম আপডেট করা হয়েছে যাতে রিপোর্টে দেখানো নামের সাথে মিল থাকে। আগে, নামগুলি clickable_annotation_impressions এবং closable_annotation_impressions হিসেবে নথিভুক্ত করা হয়েছিল।

১৮ ডিসেম্বর, ২০১৫

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

১৫ ডিসেম্বর, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে, যার সবকটিই YouTube Analytics API-কে প্রভাবিত করে:

  • YouTube Analytics API এখন তিনটি নতুন প্লেব্যাক বিবরণ ডাইমেনশন সাপোর্ট করে, যা বিভিন্ন চ্যানেল এবং কন্টেন্টের মালিকের রিপোর্টে ব্যবহার করা যেতে পারে:

    • liveOrOnDemand: এই ডাইমেনশন থেকে বোঝা যায় যে রিপোর্টে দেখানো ডেটা লাইভ সম্প্রচার চলাকালীন ব্যবহারকারীর অ্যাক্টিভিটি বর্ণনা করছে কিনা।
    • subscribedStatus: এই ডাইমেনশন থেকে বোঝা যায় যে ডেটাতে ব্যবহারকারীর অ্যাক্টিভিটি মেট্রিক ভিডিও বা প্লেলিস্টের চ্যানেলে সাবস্ক্রাইব করা দর্শকদের সাথে সম্পর্কিত কিনা।
    • youtubeProduct: এই ডাইমেনশন সেই YouTube প্রপার্টি শনাক্ত করে যেখানে ব্যবহারকারীর অ্যাক্টিভিটি ঘটেছে। সম্ভাব্য ভ্যালুর মধ্যে মূল YouTube ওয়েবসাইট (বা YouTube অ্যাপ), YouTube Gaming এবং YouTube Kids অন্তর্ভুক্ত।

    চ্যানেল এবং কন্টেন্টের মালিকদের জন্য উপলভ্য নতুন প্লেব্যাক বিবরণ রিপোর্ট শনাক্ত করতে ডকুমেন্টেশন আপডেট করা হয়েছে। এছাড়াও, আরও অনেক রিপোর্ট আপডেট করা হয়েছে যাতে উল্লেখ করা হয়েছে যে এইসব ডাইমেনশনের মধ্যে এক বা একাধিক ডাইমেনশন ঐচ্ছিকভাবে সেইসব রিপোর্টে ডাইমেনশন এবং/অথবা ফিল্টার হিসেবে ব্যবহার করা যেতে পারে।

  • রিপোর্টের ব্যাখ্যা করা টেবিলের ফর্ম্যাট পরিবর্তন করা হয়েছে যাতে আপনি প্রতিটি রিপোর্ট পাওয়ার জন্য ব্যবহার করা যেতে পারে এমন ডাইমেনশন, মেট্রিক ও ফিল্টারের সঠিক কম্বিনেশন সহজেই শনাক্ত করতে পারেন। নিচের সারণীতে চ্যানেলের জন্য "ডিভাইসের ধরন" রিপোর্ট ব্যাখ্যা করা হয়েছে এবং নতুন ফর্ম্যাট দেখানো হয়েছে:

    প্রপার্টি ভ্যালু
    মাত্রা:
    প্রয়োজনীয় deviceType
    ০ বা তার বেশি ব্যবহার করুন day, liveOrOnDemand, subscribedStatus, youtubeProduct
    মেট্রিক:
    ১ বা তার বেশি ব্যবহার করুন views, estimatedMinutesWatched
    ফিল্টার:
    ০ বা ১ ব্যবহার করুন দেশ, প্রদেশ, মহাদেশ, subContinent
    ০ বা ১ ব্যবহার করুন ভিডিও, গ্রুপ
    ০ বা তার বেশি ব্যবহার করুন operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    প্রয়োজনীয় ও ঐচ্ছিক ফিল্ডের বর্ণনা দিতে ব্যবহৃত পরিভাষা চ্যানেল ও কন্টেন্টের মালিক সংক্রান্ত রিপোর্টের ডকুমেন্টেশনে ব্যাখ্যা করা হয়েছে।

  • YouTube Analytics API এখন অটোমেটিক সেইসব এন্টিটি বাদ দিয়ে দেয় যেগুলির জন্য API ব্যবহারকারী একাধিক ভ্যালু (video, playlist এবং channel) সাপোর্ট করে এমন ফিল্টার থেকে ডেটা রিট্রিভ করতে পারেন না। আগে, API ব্যবহারকারী নির্দিষ্ট করা আইটেমগুলির মধ্যে অন্তত একটির ডেটা অ্যাক্সেস করতে না পারলে, API সার্ভার শুধু একটি সমস্যার মেসেজ দেখাত।

    যেমন, ধরুন কোনও ব্যবহারকারী API অনুরোধ জমা দিয়েছেন যেখানে video ফিল্টার ২০টি ভিডিও আইডি তালিকাভুক্ত করে। ব্যবহারকারী ১৮টি ভিডিওর মালিক। তবে, একটি ভিডিও আইডি অন্য চ্যানেলের মালিকানাধীন ভিডিও শনাক্ত করে এবং অন্য আইডিটি এমন একটি ভিডিও শনাক্ত করে যা মুছে ফেলা হয়েছে এবং তাই আর নেই। এই ক্ষেত্রে, কোনও সমস্যা দেখানোর পরিবর্তে, API সার্ভার এখন সেই দুটি ভিডিও বাদ দেয় যেগুলি ব্যবহারকারী অ্যাক্সেস করতে পারেন না এবং API রেসপন্সে ১৮টি ভিডিওর ডেটা থাকে যেগুলির মালিক হলেন API ব্যবহারকারী।

  • আপনি যদি কোনও খালি YouTube Analytics group-এর জন্য ডেটার অনুরোধ করেন, তাহলে API এখন কোনও ত্রুটির পরিবর্তে একটি খালি ডেটা সেট দেখায়।

  • আপনি যদি কোনও গ্রুপে কোনও এন্টিটি যোগ করার চেষ্টা করেন কিন্তু আপনার কাছে সেই এন্টিটির অ্যাক্সেস না থাকে, তাহলে YouTube Analytics API-এর groupItems.insert পদ্ধতি এখন একটি অননুমোদিত (403 HTTP রেসপন্স কোড) ত্রুটি দেখায়। আগে, API আপনাকে গ্রুপে এন্টিটি যোগ করার অনুমতি দিত, কিন্তু পরে আপনি যখন সেই গ্রুপের জন্য রিপোর্ট ডেটা ফিরিয়ে আনার চেষ্টা করতেন তখন একটি অননুমোদিত ত্রুটি দেখাত।

  • YouTube Analytics API-এর groups.list পদ্ধতি এখন পেজিনেশন সমর্থন করে। API রেসপন্সে উপলভ্য সব গ্রুপ না থাকলে, রেসপন্সের nextPageToken প্যারামিটার একটি টোকেন নির্দিষ্ট করে যা ফলাফলের পরবর্তী পৃষ্ঠা ফিরিয়ে আনতে ব্যবহার করা যেতে পারে। অতিরিক্ত ফলাফল পেতে, পদ্ধতির pageToken প্যারামিটারকে সেই ভ্যালুতে সেট করুন।

১০ নভেম্বর, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

২৯ অক্টোবর, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Reporting API-এর date ডাইমেনশনের ডকুমেন্টেশন সংশোধন করা হয়েছে যাতে তারিখগুলি প্যাসিফিক সময় (UTC-8) রাত ১২:০০ টায় শুরু হওয়া ২৪-ঘণ্টার সময়কালকে উল্লেখ করে। আগে, ডকুমেন্টেশনে উল্লেখ করা ছিল যে তারিখ শুরু হয় রাত ১২:০০টা (GMT) থেকে।

    এছাড়াও, YouTube Analytics API ডকুমেন্টেশন আপডেট করা হয়েছে যাতে উল্লেখ করা হয়েছে যে তারিখ সম্পর্কিত সব ডাইমেনশন (day, 7DayTotals, 30DayTotals এবং month) প্যাসিফিক টাইম (UTC-8) অনুযায়ী রাত ১২:০০টা থেকে শুরু হওয়া তারিখকে বোঝায়।

  • YouTube Reporting API-এর jobs.reports.list() পদ্ধতি এখন createdAfter কোয়েরি প্যারামিটারের সাথে কাজ করে। উল্লেখ করা থাকলে, এই প্যারামিটারটি দেখায় যে API রেসপন্সে শুধুমাত্র নির্দিষ্ট তারিখ ও সময়ের পরে তৈরি করা রিপোর্টের তালিকা দেখানো উচিত, যার মধ্যে ব্যাকফিল করা ডেটা সহ নতুন রিপোর্টও অন্তর্ভুক্ত। মনে রাখবেন যে প্যারামিটারের মান রিপোর্ট তৈরি করার সময়কে বোঝায়, রিটার্ন করা ডেটার সাথে যুক্ত তারিখকে নয়।

    প্যারামিটারের মান হল RFC3339 UTC "Zulu" ফর্ম্যাটে টাইমস্ট্যাম্প, যা মাইক্রোসেকেন্ড পর্যন্ত সঠিক। উদাহরণ: "2015-10-02T15:01:23.045678Z"।

    একই রিপোর্ট বারবার প্রসেস করা এড়াতে আপনি কীভাবে createdAfter প্যারামিটার ব্যবহার করতে পারেন তা ব্যাখ্যা করার জন্য YouTube Reporting API-এর পেশাদার পদ্ধতিও আপডেট করা হয়েছে।

  • job রিসোর্সের createTime প্রপার্টি এবং report রিসোর্সের startTime, endTime ও createTime প্রপার্টির সংজ্ঞা সংশোধন করা হয়েছে যাতে বোঝা যায় যে প্রপার্টির ভ্যালু ন্যানোসেকেন্ডে নয়, মাইক্রোসেকেন্ডে সঠিক। এছাড়াও, সব সংজ্ঞায় এখন সঠিকভাবে দেখানো হয়েছে যে প্রপার্টির ভ্যালু হল টাইমস্ট্যাম্প।

৮ অক্টোবর, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Analytics API-এর sharingService ডাইমেনশনের ডকুমেন্টেশন আপডেট করা হয়েছে যাতে সম্ভাব্য ডাইমেনশন ভ্যালুর তালিকা অন্তর্ভুক্ত করা যায়। এই তালিকায় বেশ কিছু নতুন পরিষেবা যোগ করা হয়েছে।

    YouTube Reporting API-এর sharing_service ডাইমেনশনের সংজ্ঞাও আপডেট করা হয়েছে যাতে নতুনভাবে কাজ করা ভ্যালুগুলি তালিকাভুক্ত করা যায়। 59-এর থেকে বেশি enum ভ্যালুগুলি হল তালিকার নতুন ভ্যালু।

২৪ সেপ্টেম্বর, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • নতুন YouTube Reporting API বাল্ক ডেটা রিপোর্ট ফিরিয়ে নিয়ে আসে, যার মধ্যে চ্যানেল বা কন্টেন্টের মালিকের জন্য YouTube Analytics ডেটা থাকে। এটি এমন অ্যাপ্লিকেশনের জন্য ডিজাইন করা হয়েছে যা বড় ডেটা সেট ইমপোর্ট করতে পারে এবং সেই ডেটা ফিল্টার, সাজানো এবং মাইনিং করার টুল প্রদান করে।

    প্রতিটি YouTube Reporting API রিপোর্টে আগে থেকে নির্ধারিত ডাইমেনশন ও মেট্রিকের সেট থাকে। (YouTube Analytics API রিপোর্টেও মেট্রিক ও ডাইমেনশন ব্যবহার করা হয়।) রিপোর্টে, ডেটার প্রতিটি সারিতে ডাইমেনশন ভ্যালুর অনন্য কম্বিনেশন থাকে। আপনি আলাদা আলাদা ভিডিও, দেশ, লাইভ ভিডিও, সাবস্ক্রাইব করা ব্যবহারকারী এবং আরও অনেক কিছুর জন্য মেট্রিক গণনা করতে ডাইমেনশন ভ্যালুর উপর ভিত্তি করে সারি জুড়ে ডেটা একত্রিত করতে পারেন।

    আপনি API ব্যবহার করে রিপোর্টিংয়ের কাজ শিডিউল করতে পারেন, যার প্রতিটি YouTube-এর তৈরি করা উচিত এমন একটি রিপোর্ট শনাক্ত করে। আপনি কোনও কাজ সেট-আপ করার পরে, YouTube একটি দৈনিক রিপোর্ট তৈরি করে যা অ্যাসিঙ্ক্রোনাসভাবে ডাউনলোড করা যেতে পারে। প্রতিটি রিপোর্টে ২৪ ঘণ্টার অনন্য সময়সীমার ডেটা থাকে।

  • যদিও এগুলি আলাদা API, YouTube Analytics API এবং YouTube Reporting API, দুটিই ডেভেলপারদের YouTube Analytics ডেটা রিট্রিভ করতে দেয়। দুটি API-ই একই ধরনের ডেটা সেটে অ্যাক্সেস প্রদান করে, তাই দুটি API-এর ডকুমেন্টেশন একটি ডকুমেন্টেশন সেট হিসেবে প্রকাশ করা হচ্ছে।

    • ডকুমেন্টেশন সেটের নির্দেশিকা ট্যাবে দুটি API-এর জন্যই সাধারণ তথ্য রয়েছে, যার মধ্যে API অনুরোধ অনুমোদনের নির্দেশাবলীও রয়েছে।
    • বাল্ক রিপোর্ট ট্যাবে রেফারেন্স ডকুমেন্টেশন এবং অন্যান্য কন্টেন্ট থাকে যা বিশেষভাবে YouTube Reporting API-এর জন্য তৈরি।
    • টার্গেট করা কোয়েরি ট্যাবে রেফারেন্স ডকুমেন্টেশন এবং YouTube Analytics API-এর জন্য নির্দিষ্ট অন্যান্য কন্টেন্ট থাকে।
    • Samples ট্যাবে দুটি API-এর যেকোনও একটির জন্য উপলভ্য কোড স্যাম্পেল তালিকাভুক্ত করা থাকে।
    • টুল ট্যাবে অতিরিক্ত রিসোর্স তালিকাভুক্ত করা আছে যা ডেভেলপারদের দুটি API-এর যেকোনও একটি প্রয়োগ করতে সাহায্য করে।

২০ আগস্ট, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API আরও সহজে বোঝার জন্য API ডকুমেন্টেশন নতুনভাবে সাজানো হয়েছে। এইসব পরিবর্তন নতুন ফিচার সম্পর্কে কিছু বলে না:

    • ডকুমেন্টেশনে এখন একটি পৃষ্ঠা রয়েছে যা উপলভ্য সমস্ত চ্যানেল রিপোর্ট তালিকাভুক্ত করে এবং অন্যটি উপলভ্য সমস্ত কন্টেন্টের মালিকের রিপোর্ট তালিকাভুক্ত করে। আগে, ডকুমেন্টেশনে চ্যানেল ভিডিও রিপোর্ট, চ্যানেল প্লেলিস্ট রিপোর্ট এবং আরও অনেক কিছুর জন্য আলাদা পৃষ্ঠা ছিল।

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

    • API-এর reports.query পদ্ধতি, যা আপনি রিপোর্ট ফিরিয়ে আনার জন্য ব্যবহার করেন, এখন আলাদাভাবে ডকুমেন্ট করা হয়েছে। সেই পৃষ্ঠার তথ্য আগে অন্য কোনও পৃষ্ঠায় ছিল। নতুন পৃষ্ঠাটি এমনভাবে ডিজাইন করা হয়েছে যাতে আপনি কোনও রিপোর্ট ফিরিয়ে আনার জন্য প্রয়োজনীয় তথ্য আরও সহজে শনাক্ত করতে পারেন।

২২ জুলাই, ২০১৫

এই আপডেটে একাধিক পরিবর্তন রয়েছে, যার সবকটিই শুধুমাত্র কন্টেন্টের মালিকদের ক্ষেত্রে প্রযোজ্য:

  • নতুন adEarnings মেট্রিক Google-এর বিক্রি করা সব বিজ্ঞাপন সোর্স থেকে মোট আনুমানিক উপার্জন (মোট উপার্জন) অন্তর্ভুক্ত করে। এটি কোনও মূল মেট্রিক নয়। যেসব রিপোর্টে আগে থেকেই earnings মেট্রিক কাজ করে, সেগুলিতে API adEarnings মেট্রিকও কাজ করে।

    এছাড়াও, earnings মেট্রিকের সংজ্ঞা সংশোধন করা হয়েছে যাতে এটি দেখানো যায় যে এর ভ্যালুতে Google-এর বিক্রি করা সমস্ত বিজ্ঞাপন সোর্স এবং বিজ্ঞাপন ছাড়া অন্যান্য সোর্স থেকে মোট আনুমানিক উপার্জন অন্তর্ভুক্ত রয়েছে। আগে, সংজ্ঞায় ভুল করে উল্লেখ করা হয়েছিল যে মেট্রিকটি শুধুমাত্র বিজ্ঞাপনের সোর্স থেকে হওয়া উপার্জন অন্তর্ভুক্ত করে।

  • primaryAdGrossRevenue মেট্রিক বন্ধ করে দেওয়া হয়েছে। পরিবর্তে, উপার্জন সংক্রান্ত ডেটা পেতে grossRevenue মেট্রিক ব্যবহার করুন।

  • বন্ধ হয়ে যাওয়া primaryAdGrossRevenue মেট্রিক ছাড়াও, বিজ্ঞাপনের পারফর্ম্যান্স সংক্রান্ত রিপোর্টে আর monetizedPlaybacks ও playbackBasedCpm মেট্রিক কাজ করে না। তবে, বেশ কিছু ভিডিও রিপোর্ট এখনও এইসব মেট্রিক সাপোর্ট করে।

১ জুন, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন ভিডিও রিপোর্টের জন্য দুটি নতুন মেট্রিক সাপোর্ট করে, videosAddedToPlaylists এবং videosRemovedFromPlaylists। চ্যানেল এবং কন্টেন্টের মালিক, উভয়ের জন্যই ভিডিও রিপোর্টের তালিকা আপডেট করা হয়েছে যাতে নতুন মেট্রিককে সাপোর্ট করে এমন রিপোর্ট শনাক্ত করা যায়।

    • videosAddedToPlaylists – কোয়েরির স্কোপে থাকা ভিডিওগুলি যতবার YouTube-এর কোনও প্লেলিস্টে যোগ করা হয়েছে। ভিডিওগুলি ভিডিওর মালিকের প্লেলিস্টে বা অন্য চ্যানেলের প্লেলিস্টে যোগ করা হতে পারে।
    • videosRemovedFromPlaylists – কোয়েরির স্কোপে থাকা ভিডিওগুলি যতবার যেকোনও YouTube প্লেলিস্ট থেকে সরানো হয়েছে। ভিডিওগুলি ভিডিওর মালিকের প্লেলিস্ট বা অন্য চ্যানেলের প্লেলিস্ট থেকে সরানো হতে পারে।

    দুটি মেট্রিকের মধ্যেই "পরে দেখুন" প্লেলিস্টের মতো ডিফল্ট প্লেলিস্ট অন্তর্ভুক্ত থাকে। তবে, কোনও ভিডিও অটোমেটিক যোগ করা হয়েছে এমন প্লেলিস্ট, যেমন চ্যানেলের আপলোড করা প্লেলিস্ট বা ব্যবহারকারীর দেখার ইতিহাস, এতে গণনা করা হয় না। এছাড়াও মনে রাখবেন যে এইসব মেট্রিক যোগ ও মুছে ফেলার পরম সংখ্যা দেখায়। তাই, কোনও ব্যবহারকারী প্লেলিস্টে ভিডিও যোগ করার পরে সেটি সরিয়ে দিলে এবং আবার যোগ করলে, মেট্রিক্সে দেখানো হবে যে ভিডিওটি দুটি প্লেলিস্টে যোগ করা হয়েছে এবং একটি থেকে সরানো হয়েছে।

    এইসব মেট্রিকের ডেটা ১ অক্টোবর, ২০১৪ থেকে উপলভ্য।

৩১ মার্চ, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • এই ঘোষণা অনুযায়ী favoritesAdded এবং favoritesRemoved মেট্রিক দুটিই বন্ধ করে দেওয়া হয়েছে। এই দুটিই হল মূল মেট্রিক এবং পরিষেবার শর্তাবলীতে উল্লেখ করা শীঘ্রই বন্ধ করা সংক্রান্ত নীতি অনুযায়ী এগুলি পরিচালিত হয়।

১৬ মার্চ, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • নতুন currency প্যারামিটার আপনাকে মার্কিন ডলার (USD) ছাড়া অন্য মুদ্রায় উপার্জনের মেট্রিক দেখতে দেয়। প্যারামিটার সেট করা থাকলে, API earnings, grossRevenue, playbackBasedCpm এবং impressionBasedCpm মেট্রিকের মান নির্দিষ্ট মুদ্রায় কনভার্ট করে। প্রতিদিনের এক্সচেঞ্জ রেট অনুযায়ী আনুমানিক উপার্জন হিসেব করা হয়।

    প্যারামিটারের মান হল তিন অক্ষরের ISO 4217 কারেন্সি কোড। ডিফল্ট ভ্যালু হল USD। প্যারামিটার সংজ্ঞায় কাজ করে এমন কারেন্সি কোডের তালিকা রয়েছে।

২৫ ফেব্রুয়ারি, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন YouTube Analytics গ্রুপ তৈরি ও ম্যানেজ করার পাশাপাশি সেইসব গ্রুপের জন্য রিপোর্ট ডেটা ফিরিয়ে আনার সুবিধা প্রদান করে।

    • গ্রুপ তৈরি ও ম্যানেজ করা

      এই আপডেট গ্রুপ তৈরি ও ম্যানেজ করার জন্য group এবং groupItem রিসোর্স নিয়ে আসে।

      • group রিসোর্স Analytics গ্রুপকে দেখায়, এটি সর্বাধিক ২০০টি চ্যানেল, ভিডিও, প্লেলিস্ট বা অ্যাসেটের কাস্টম সংগ্রহ। এই রিসোর্সের জন্য API list, insert, update এবং delete পদ্ধতি সমর্থন করে।
      • groupItem রিসোর্স Analytics গ্রুপের একটি আইটেমকে বোঝায়। এই রিসোর্সের জন্য API list, insert এবং delete পদ্ধতি সাপোর্ট করে।

      যেমন, আপনি groups.insert পদ্ধতি ব্যবহার করে একটি গ্রুপ তৈরি করতে পারেন এবং তারপর groupItems.insert পদ্ধতি ব্যবহার করে সেই গ্রুপে আইটেম যোগ করতে পারেন।

    • কোনও গ্রুপের জন্য রিপোর্ট ডেটা ফিরিয়ে আনা

      ডাইমেনশন সংক্রান্ত ডকুমেন্টেশন আপডেট করা হয়েছে যাতে group ডাইমেনশন অন্তর্ভুক্ত করা যায়, যা অনেক চ্যানেল রিপোর্ট এবং কন্টেন্টের মালিকের রিপোর্ট-এর জন্য ফিল্টার হিসেবে ব্যবহার করা যেতে পারে। আপনি group ফিল্টার ব্যবহার করলে, API সেই গ্রুপের সব আইটেমের ডেটা দেখায়। মনে রাখবেন, API বর্তমানে অ্যাসেট গ্রুপের জন্য রিপোর্ট তৈরি করার সুবিধা প্রদান করে না।

    YouTube Analytics গ্রুপ সম্পর্কে আরও তথ্য পেতে YouTube সহায়তা কেন্দ্র দেখুন।

১৩ ফেব্রুয়ারি, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API-তে আর show ডাইমেনশন কাজ করে না।

২৮ আগস্ট, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন video, playlist, channel এবং show ডাইমেনশনের জন্য একাধিক মান নির্দিষ্ট করার ক্ষমতাকে সমর্থন করে যখন সেই ডাইমেনশনগুলি ফিল্টার হিসাবে ব্যবহার করা হয়। একাধিক মান নির্দিষ্ট করতে, filters প্যারামিটারের মানকে ভিডিও, প্লেলিস্ট, চ্যানেল বা শো আইডির কমা দ্বারা আলাদা করা তালিকা হিসেবে সেট করুন যার জন্য API রেসপন্স ফিল্টার করা উচিত। প্যারামিটারের ভ্যালু সর্বাধিক ২০০টি আইডি নির্দিষ্ট করতে পারে।

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

    এই কার্যকারিতা সম্পর্কে সম্পূর্ণ বিবরণ পেতে filters প্যারামিটারের সংজ্ঞা দেখুন।

১৬ জুলাই, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • চ্যানেল রিপোর্ট পাওয়ার সময়, আপনি এখন ids প্যারামিটারের ভ্যালু channel==MINE-এ সেট করে যাচাই করা ব্যবহারকারীর চ্যানেলের ডেটা পেতে পারেন। (এছাড়াও, আপনি এখনও নির্দিষ্ট চ্যানেলের জন্য ডেটা পেতে ids প্যারামিটার channel==CHANNEL_ID-এ সেট করতে পারেন।)

  • API এখন প্লেলিস্ট রিপোর্ট সমর্থন করে, যাতে প্লেলিস্টের প্রসঙ্গে ঘটে যাওয়া ভিডিও ভিউ সম্পর্কিত পরিসংখ্যান থাকে। চ্যানেল ও কন্টেন্টের মালিক প্লেলিস্ট রিপোর্ট দেখতে পাবেন।

    সব প্লেলিস্ট রিপোর্টে views ও estimatedMinutesWatched মেট্রিক কাজ করে এবং কিছু রিপোর্টে averageViewDuration মেট্রিকও কাজ করে।

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

    • playlistStarts: দর্শকদের দ্বারা একটি প্লেলিস্টের প্লেব্যাক শুরু করার সংখ্যা৷
    • viewsPerPlaylistStart: প্রতিবার প্লেলিস্ট শুরু হওয়ার পরে ভিডিও দেখার গড় সংখ্যা৷
    • averageTimeInPlaylist: প্লেলিস্ট শুরু হওয়ার পরে, একজন দর্শক প্লেলিস্টের ভিডিওগুলি আনুমানিক গড়ে যত মিনিট দেখেছেন।

    প্লেলিস্ট রিপোর্ট ফিরিয়ে আনার যেকোনও অনুরোধে isCurated ফিল্টার ব্যবহার করতে হবে, যা 1 (isCurated==1) হিসেবে সেট করতে হবে।

  • API এখন দর্শক ধরে রাখার রিপোর্ট সাপোর্ট করে। এই রিপোর্ট থেকে কোনও ভিডিও কতক্ষণ দর্শককে ধরে রাখতে পারছে তা পরিমাপ করা হয়। রিপোর্টের নতুন elapsedVideoTimeRatio ডাইমেনশন সংশ্লিষ্ট মেট্রিক ভ্যালুর জন্য ভিডিওর কতটা অংশ দেখা হয়েছে তা পরিমাপ করে:

    • audienceWatchRatio মেট্রিক ভিডিওর নির্দিষ্ট পয়েন্টে ভিডিও দেখছেন এমন দর্শকদের চূড়ান্ত অনুপাত শনাক্ত করে। ভিডিওর কোনও অংশ যতবার দেখা হয়েছে তার সাথে ভিডিওর মোট ভিউয়ের সংখ্যা তুলনা করে অনুপাত গণনা করা হয়।

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

    • relativeRetentionPerformance মেট্রিক থেকে বোঝা যায় যে একই দৈর্ঘ্যের অন্যান্য YouTube ভিডিওর তুলনায় আপনার ভিডিও প্লেব্যাক করার সময় দর্শকদের মনোযোগ কতটা ধরে রাখতে পারছে। ০ মানটি দেখায় যে ভিডিওটি একই দৈর্ঘ্যের অন্য যেকোনও ভিডিওর চেয়ে দর্শকদের মনোযোগ ধরে রাখার ক্ষেত্রে খারাপ পারফর্ম করেছে, যেখানে ১ মানটি দেখায় যে ভিডিওটি একই দৈর্ঘ্যের অন্য যেকোনও ভিডিওর চেয়ে দর্শকদের মনোযোগ ধরে রাখার ক্ষেত্রে ভাল পারফর্ম করেছে। ০.৫-এর মধ্যক মান থেকে বোঝা যায় যে একই দৈর্ঘ্যের অর্ধেক ভিডিওতে দর্শক ধরে রাখার হার বেশি এবং বাকি অর্ধেক ভিডিওতে দর্শক ধরে রাখার হার কম।

    এছাড়াও, আপনি audienceType ফিল্টার ব্যবহার করতে পারেন যাতে রিপোর্টে শুধুমাত্র অর্গানিক ভিউ, TrueView ইন-স্ট্রিম বিজ্ঞাপন থেকে পাওয়া ভিউ বা TrueView ইন-ডিসপ্লে বিজ্ঞাপন থেকে পাওয়া ভিউ সম্পর্কিত ডেটা দেখানো হয়। (অর্গ্যানিক ভিউ হল ব্যবহারকারীর অ্যাকশনের সরাসরি ফলাফল, যেমন কোনও ভিডিও সার্চ করা বা সাজেস্ট করা ভিডিওতে ক্লিক করা।)

  • API-তে অ্যানোটেশন সম্পর্কিত বেশ কিছু নতুন মেট্রিক কাজ করে। নিচে তালিকাভুক্ত মেট্রিকগুলি এমন যেকোনও রিপোর্টের মাধ্যমে ফিরিয়ে আনা যেতে পারে যেগুলি আগে annotationClickThroughRate এবং annotationCloseRate মেট্রিককে সাপোর্ট করত।

    • annotationImpressions: মোট অ্যানোটেশন ইম্প্রেশনের সংখ্যা।
    • annotationClickableImpressions: যতগুলি অ্যানোটেশন দেখানো হয়েছে এবং ক্লিক করা যেতে পারে।
    • annotationClosableImpressions: যতগুলি অ্যানোটেশন দেখানো হয়েছে এবং বন্ধ করা যেতে পারে।
    • annotationClicks: ক্লিক করা অ্যানোটেশনের মোট সংখ্যা।
    • annotationCloses: বন্ধ করা অ্যানোটেশনের মোট সংখ্যা।

    সব নতুন মেট্রিক হল মূল মেট্রিক এবং এগুলি শীঘ্রই বন্ধ করা সংক্রান্ত নীতি অনুযায়ী কাজ করে। তবে, মনে রাখবেন যে ১৬ জুলাই, ২০১৩ থেকে নতুন মেট্রিক্সের জন্য ডেটা উপলভ্য। (annotationClickThroughRate এবং annotationCloseRate মেট্রিকের ডেটা ১০ জুন, ২০১২ থেকে উপলভ্য।)

  • insightTrafficSourceType ডাইমেনশনের জন্য GOOGLE_SEARCH আর আলাদা ভ্যালু হিসেবে রিপোর্ট করা হয় না। পরিবর্তে, Google সার্চ ফলাফল থেকে আসা রেফারেল এখন EXT_URL ট্রাফিক সোর্সের ধরন হিসেবে অ্যাট্রিবিউট করা হয়। এর ফলে, insightTrafficSourceDetail রিপোর্ট আর ফিরিয়ে আনা যাবে না যা insightTrafficSourceType ফিল্টারকে GOOGLE_SEARCH-এ সেট করে।

৩১ জানুয়ারি, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

১৬ জানুয়ারি, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • স্যাম্পেল অনুরোধ ডকুমেন্টটি নতুনভাবে ডিজাইন করা হয়েছে যাতে উদাহরণগুলি বিভিন্ন বিভাগে গ্রুপ করা যায়। এর জন্য একটি ট্যাব ফর্ম্যাট ব্যবহার করা হয়েছে, যা সম্প্রতি চ্যানেল এবং কন্টেন্টের মালিকদের রিপোর্টের জন্য রিলিজ করা ফর্ম্যাটের মতোই। নতুন ডিজাইনে, উদাহরণগুলি নিম্নলিখিত বিভাগে গ্রুপ করা হয়েছে:

    • প্রাথমিক পরিসংখ্যান
    • সময় ভিত্তিক
    • ভৌগোলিক
    • প্লেব্যাক লোকেশন
    • ট্রাফিকের উৎস
    • ডিভাইস/OS
    • জনতাত্ত্বিক
    • সোশ্যাল
    • উপার্জন/বিজ্ঞাপন (শুধুমাত্র কন্টেন্টের মালিকের রিপোর্টের জন্য)

  • স্যাম্পেল অনুরোধ ডকুমেন্টে এখন চ্যানেল রিপোর্ট বা কন্টেন্ট মালিকের রিপোর্টে প্রদেশ-নির্দিষ্ট ডেটা ফিরিয়ে আনার জন্য নতুন উদাহরণ অন্তর্ভুক্ত করা হয়েছে।

    • মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং ওয়াশিংটন ডি.সি.-এর জন্য প্রদেশ-নির্দিষ্ট মেট্রিক: এই রিপোর্ট থেকে কোনও চ্যানেলের ভিডিওর ভিউ কাউন্ট ও অন্যান্য পরিসংখ্যানের প্রদেশ-ভিত্তিক ব্রেকডাউন পাওয়া যায়। এই ডেটা মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং ওয়াশিংটন ডি.সি. কভার করে। উদাহরণটি province ডাইমেনশন ব্যবহার করে এবং মার্কিন যুক্তরাষ্ট্রের ফলাফল অন্তর্ভুক্ত করার জন্য উত্তর সীমাবদ্ধ করতে filters প্যারামিটারও ব্যবহার করে।

    • ক্যালিফোর্নিয়ায় দর্শকের ডেমোগ্রাফি (বয়সের গ্রুপ ও লিঙ্গগত পরিচয়): এই রিপোর্ট ক্যালিফোর্নিয়ায় দর্শকের বয়সের গ্রুপ ও লিঙ্গগত পরিচয় সংক্রান্ত পরিসংখ্যান দেখায় যারা কোনও চ্যানেলের ভিডিও বা কন্টেন্টের মালিকের রিপোর্ট অনুযায়ী, কন্টেন্টের মালিকের দাবি করা কন্টেন্ট দেখেছেন। এই উদাহরণে filters প্যারামিটার ব্যবহার করা হয়েছে যাতে উত্তরে শুধু নির্দিষ্ট প্রদেশের ডেটা দেখানো হয়।

  • province ডাইমেনশনের সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে province যখন dimensions প্যারামিটারের ভ্যালুতে অন্তর্ভুক্ত থাকে, তখন অনুরোধে অবশ্যই country==US-কে filters প্যারামিটারের ভ্যালুতে অন্তর্ভুক্ত করে মার্কিন যুক্তরাষ্ট্রে ডেটা সীমাবদ্ধ করতে হবে।

৬ জানুয়ারি, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • যেসব ডকুমেন্টে কাজ করে এমন চ্যানেল ও কন্টেন্টের মালিক সংক্রান্ত রিপোর্টের তালিকা থাকে, সেগুলি নতুন করে ডিজাইন করা হয়েছে। সম্ভাব্য সব রিপোর্টের তালিকা সহ টেবিল প্রদান করার পরিবর্তে, প্রতিটি ডকুমেন্ট রিপোর্টগুলিকে বিভিন্ন বিভাগে ভাগ করে:

    • প্রাথমিক পরিসংখ্যান
    • সময় ভিত্তিক
    • ভৌগোলিক
    • প্লেব্যাক লোকেশন
    • ট্রাফিকের উৎস
    • ডিভাইস/OS
    • জনতাত্ত্বিক
    • সোশ্যাল
    • সেরা ভিডিও

    প্রতিটি ডকুমেন্ট এইসব বিভাগকে ট্যাবের তালিকা হিসেবে দেখায় এবং আপনি যেকোনও ট্যাবে ক্লিক করে সেই বিভাগের কাজ করে এমন রিপোর্ট দেখতে পারবেন।

  • API এখন তিনটি নতুন ভৌগোলিক ডাইমেনশন সাপোর্ট করে: province, continent এবং subContinent।

    • province ডাইমেনশন আপনাকে মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার পরিসংখ্যান পেতে দেয়। এই ডাইমেনশনের জন্য API দুটি ব্যবহার সমর্থন করে:

      • API-তে দুটি রিপোর্ট কাজ করে যা রাজ্য-ভিত্তিক পরিসংখ্যান দেখায়। চ্যানেল এবং কন্টেন্টের মালিক, উভয়ের জন্যই দুটি রিপোর্টই উপলভ্য।

        • কোর স্ট্যাটস রিপোর্ট থেকে ভিউয়ের সংখ্যা এবং আনুমানিক কত মিনিট দেখা হয়েছে সহ বিভিন্ন পরিসংখ্যান পাওয়া যায়।
        • সময়-ভিত্তিক রিপোর্ট একই পরিসংখ্যান প্রদান করে, তবে দৈনিক, ৭-দিন, ৩০-দিন বা মাসিক ভিত্তিতে ডেটা একত্রিত করে।

      • কোনও নির্দিষ্ট রাজ্যের জন্য শুধুমাত্র পরিসংখ্যান অন্তর্ভুক্ত করার জন্য রিপোর্ট সীমাবদ্ধ করতে আপনি filters কোয়েরি প্যারামিটার ব্যবহার করতে পারেন। ভৌগোলিক রিপোর্ট, প্লেব্যাক লোকেশন রিপোর্ট, ট্রাফিক সোর্স রিপোর্ট, ডিভাইস রিপোর্ট, অপারেটিং সিস্টেম রিপোর্ট, ডেমোগ্রাফিক রিপোর্ট এবং সেরা ভিডিও রিপোর্ট সহ বিভিন্ন রিপোর্টে এই ধরনের ফিল্টার ব্যবহার করা যায়।

    • continent ডাইমেনশনটি একটি মহাদেশকে শনাক্ত করে এমন একটি ইউনাইটেড নেশনস (UN) স্ট্যাটিস্টিক্যাল অঞ্চল কোড নির্দিষ্ট করে। এই ডাইমেনশন শুধুমাত্র ফিল্টার হিসেবে ব্যবহার করা যাবে।

    • subContinent ডাইমেনশনটি একটি মহাদেশের উপ-অঞ্চলকে শনাক্ত করে এমন একটি ইউনাইটেড নেশনস (UN) স্ট্যাটিস্টিক্যাল অঞ্চল কোড নির্দিষ্ট করে। এছাড়াও, এই ডাইমেনশন শুধুমাত্র ফিল্টার হিসেবে ব্যবহার করা যেতে পারে।

      প্রতিটি সাব-রিজিয়ন যেহেতু একটি মহাদেশের সাথে যুক্ত, তাই আপনি subContinent ফিল্টার ব্যবহার করলে continent ফিল্টার ব্যবহার করার প্রয়োজন নেই। (আসলে, কোনও অনুরোধে দুটি ডাইমেনশনই ব্যবহার করা হলে API একটি ত্রুটি দেখাবে।)

  • ডকুমেন্টেশন সংশোধন করা হয়েছে যাতে insightTrafficSourceDetail ডাইমেনশনে insightTrafficSourceType ভ্যালু PROMOTED সঠিক ফিল্টার ভ্যালু হিসেবে অন্তর্ভুক্ত না হয়।

৩০ সেপ্টেম্বর, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Analytics API এখন পরিষেবার শর্তাবলীতে বর্ণিত শীঘ্রই বন্ধ করা সংক্রান্ত নীতি অনুযায়ী পরিচালিত হয়। তবে, API-এর নন-কোর ডাইমেনশন এবং নন-কোর মেট্রিক শীঘ্রই বন্ধ করা সংক্রান্ত নীতির আওতাভুক্ত নয়। ডাইমেনশন এবং মেট্রিক পৃষ্ঠাগুলি মূল ডাইমেনশন এবং মূল মেট্রিক তালিকাভুক্ত করার জন্য আপডেট করা হয়েছে। এছাড়াও, মূল ডাইমেনশন ও মেট্রিক স্পষ্টভাবে শনাক্ত করার জন্য সেইসব পৃষ্ঠায় সংজ্ঞা আপডেট করা হয়েছে।

  • API এখন insightPlaybackLocationType ডাইমেনশনের ভ্যালু হিসেবে EXTERNAL_APP-কে সাপোর্ট করে। এই আপডেটের সাথে, ১০ সেপ্টেম্বর, ২০১৩ থেকে, প্লেব্যাকগুলিকে আর MOBILE প্লেব্যাক হিসাবে শ্রেণীবদ্ধ করা হয় না, যদিও সেই তারিখের আগে হওয়া মোবাইল প্লেব্যাকগুলি এখনও সেই ভ্যালুর সাথে শ্রেণীবদ্ধ করা হবে।

    এই আপডেটের মাধ্যমে, মোবাইল প্লেব্যাক এখন WATCH, EMBEDDED অথবা EXTERNAL_APP প্লেব্যাক হিসেবে শ্রেণীবদ্ধ করা হয়, যা প্লেব্যাক হওয়া অ্যাপ্লিকেশনের ধরনের উপর নির্ভর করে।

  • API এখন insightTrafficSourceType ডাইমেনশনের ভ্যালু হিসেবে PLAYLIST-কে সাপোর্ট করে। এই ভ্যালু থেকে বোঝা যায় যে ভিডিও ভিউ প্লেলিস্ট থেকে রেফার করা হয়েছে। আগে, এই ভিউগুলি ডাইমেনশনের YT_OTHER_PAGE বিভাগ ব্যবহার করে শ্রেণীবদ্ধ করা হত।

১৬ জুলাই, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন একাধিক ডাইমেনশন এবং মেট্রিক অনুসারে রিপোর্ট সাজানোর সুবিধা প্রদান করে। স্যাম্পেল অনুরোধের ডকুমেন্টে একটি নতুন উদাহরণ রয়েছে, একাধিক ডাইমেনশন/মেট্রিক অনুযায়ী অনুরোধ সাজানো, যা এই কার্যকারিতা দেখায়। অনুরোধটি ট্রাফিক সোর্স ডেটা ফিরিয়ে আনে এবং এতে day,-views-এর sort প্যারামিটার মান রয়েছে। ফলাফলগুলি কালানুক্রমিকভাবে সাজানো হয়, তবে প্রতিটি দিনের ফলাফল সেটের মধ্যে, প্রথম সারিতে ট্রাফিক সোর্সের ডেটা থাকে যা সবচেয়ে বেশি ভিউ তৈরি করে, দ্বিতীয় সারিতে সেই সোর্সের ডেটা থাকে যা পরবর্তী সর্বোচ্চ পরিমাণ ভিউ তৈরি করে এবং আরও অনেক কিছু।

  • API এখন দুটি নতুন ডাইমেনশন সাপোর্ট করে, deviceType এবং operatingSystem, যেগুলি দর্শকরা আপনার ভিডিও দেখছেন এমন ডিভাইস সম্পর্কে ডেটা সংগ্রহ করতে ব্যবহার করা যেতে পারে। API এমন রিপোর্টকে সাপোর্ট করে যা যেকোনও একটি বা দুটি ডাইমেনশনই ব্যবহার করে।

    • deviceType রিপোর্ট থেকে আপনি ডেস্কটপ, মোবাইল ও ট্যাবলেট সহ বিভিন্ন ধরনের ডিভাইসের জন্য ভিউ কাউন্ট ও আনুমানিক দেখার সময় সংক্রান্ত তথ্য পাবেন। এছাড়াও, আপনি operatingSystem ফিল্টার ব্যবহার করে ডিভাইসের ধরন সংক্রান্ত রিপোর্ট সীমিত করতে পারেন যাতে শুধুমাত্র Android বা iOS-এর মতো নির্দিষ্ট অপারেটিং সিস্টেমে চলা ডিভাইসের পরিসংখ্যান থাকে।

    • operatingSystem রিপোর্ট থেকে আপনি Android, iOS, Linux এবং আরও অনেক কিছুর মতো বিভিন্ন অপারেটিং সিস্টেমের জন্য ভিউ কাউন্ট এবং আনুমানিক দেখার সময় পুনরুদ্ধার করতে পারবেন। এছাড়াও, আপনি deviceType ফিল্টার ব্যবহার করে অপারেটিং সিস্টেম রিপোর্টকে সীমাবদ্ধ করতে পারেন যাতে শুধুমাত্র নির্দিষ্ট ধরনের ডিভাইসের পরিসংখ্যান থাকে, যেমন মোবাইল ডিভাইস বা ট্যাবলেট।

    নতুন ডিভাইসের ধরন ও অপারেটিং সিস্টেম সংক্রান্ত রিপোর্ট চ্যানেল ও কন্টেন্টের মালিকদের জন্য উপলভ্য।

  • স্যাম্পেল অনুরোধ সংক্রান্ত ডকুমেন্ট আপডেট করা হয়েছে যাতে চ্যানেলের জন্য তিনটি ডিভাইস রিপোর্ট এবং কন্টেন্টের মালিকের জন্য তিনটি ডিভাইস রিপোর্ট অন্তর্ভুক্ত করা যায়।

  • insightPlaybackLocationType ডাইমেনশন YT_OTHER ভ্যালু দেখাতে পারে, যা ডাইমেনশনের অন্যান্য ভ্যালু ব্যবহার করে শ্রেণীবদ্ধ করা হয়নি এমন ভিউ শনাক্ত করে।

২৩ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

১০ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

৬ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন দেখার সময় মেট্রিক্স – estimatedMinutesWatched, averageViewDuration এবং averageViewPercentage – ভিউ মেট্রিক্স, এনগেজমেন্ট মেট্রিক্স, উপার্জন মেট্রিক্স এবং বিজ্ঞাপন পারফর্ম্যান্স মেট্রিক্স সহ অন্যান্য মেট্রিক্সের সাথে একত্রে পুনরুদ্ধার করার ক্ষমতাকে সমর্থন করে।

    এই পরিবর্তন দেখানোর জন্য উপলভ্য চ্যানেল রিপোর্ট এবং কন্টেন্টের মালিকের রিপোর্ট-এর তালিকা আপডেট করা হয়েছে। (তালিকাগুলি এখন আসলে ছোট কারণ দেখার সময় মেট্রিক অন্যান্য তালিকাভুক্ত রিপোর্টের অংশ হিসেবে পাওয়া যেতে পারে।)

    Sample API অনুরোধ সংক্রান্ত ডকুমেন্টও আপডেট করা হয়েছে।

  • যেসব রিপোর্টে insightPlaybackLocationDetail এবং insightTrafficSourceDetail ডাইমেনশন ব্যবহার করা হয়, সেগুলি নিম্নলিখিত উপায়ে উন্নত করা হয়েছে:

    • এগুলি এখন একটি ঐচ্ছিক country ফিল্টার সমর্থন করে।

    • কন্টেন্টের মালিকরা এখন নিম্নলিখিত যেকোনও নতুন filter কম্বিনেশন ব্যবহার করে এইসব রিপোর্ট ফিরিয়ে আনতে পারবেন। মনে রাখবেন, এই সব কম্বিনেশন ঐচ্ছিক country ফিল্টারও সাপোর্ট করে।

      • প্লেব্যাক লোকেশনের বিবরণ

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • ট্রাফিক সোর্সের বিবরণ

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

৩ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • নতুন Sample API অনুরোধ ডকুমেন্ট এমন উদাহরণ প্রদান করে যা দেখায় যে কীভাবে YouTube Analytics API ব্যবহার করে বিভিন্ন ধরনের রিপোর্ট পাওয়া যায়। প্রতিটি উদাহরণে অনুরোধের মাধ্যমে পাওয়া রিপোর্টের সংক্ষিপ্ত বিবরণ থাকে এবং তারপরে অনুরোধের জন্য ডায়মেনশন, মেট্রিক, ফিল্টার ও সাজানোর প্যারামিটার দেখানো হয়।

  • insightTrafficSourceType ডাইমেনশন এখন সঠিক ভ্যালু হিসেবে SUBSCRIBER-কে সাপোর্ট করে। এই ভ্যালু থেকে সেইসব ভিডিও ভিউ শনাক্ত করা যায় যেগুলি YouTube হোমপেজের ফিড বা YouTube সাবস্ক্রিপশন ফিচার থেকে রেফার করা হয়েছে। আপনি এই ট্রাফিক সোর্সের ভিত্তিতে ফিল্টার করলে, insightTrafficSourceDetail ফিল্ডে হোমপেজ ফিড বা অন্য পৃষ্ঠা উল্লেখ করা থাকবে যেখান থেকে ভিউ রেফার করা হয়েছে।

২৮ মার্চ, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন দুটি নতুন মেট্রিক সাপোর্ট করে, annotationClickThroughRate এবং annotationCloseRate, যা আপনার ভিডিও চলাকালীন দেখানো অ্যানোটেশনের সাথে দর্শকের ইন্টার‍্যাকশনের সাথে সম্পর্কিত। নতুন মেট্রিক্সে কাজ করে এমন রিপোর্ট শনাক্ত করতে চ্যানেল রিপোর্ট এবং কন্টেন্টের মালিকের রিপোর্ট, দুটিরই তালিকা আপডেট করা হয়েছে।

    • annotationClickThroughRate – ক্লিক করা যায় এমন টীকা ইম্প্রেশনের মোট সংখ্যার সাথে দর্শকরা ক্লিক করেছেন এমন টীকার অনুপাত।
    • annotationCloseRate – টীকা ইম্প্রেশনের মোট সংখ্যার মধ্যে দর্শকরা বন্ধ করে দিয়েছেন এমন টীকার অনুপাত।

২১ মার্চ, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API এখন উপার্জন ও বিজ্ঞাপনের পারফর্ম্যান্স মেট্রিক্সের পাশাপাশি নতুন বিজ্ঞাপনের পারফর্ম্যান্স রিপোর্টও সাপোর্ট করে। YouTube পার্টনার প্রোগ্রামে অংশগ্রহণকারী YouTube কন্টেন্ট পার্টনাররা মেট্রিক ও রিপোর্ট অ্যাক্সেস করতে পারবেন।

    • নতুনভাবে কাজ করা রিপোর্ট প্লেব্যাক-ভিত্তিক বিজ্ঞাপন পারফর্ম্যান্স মেট্রিক এবং ইম্প্রেশন-ভিত্তিক বিজ্ঞাপন পারফর্ম্যান্স মেট্রিককে সাপোর্ট করে। বিজ্ঞাপনের পারফর্ম্যান্স রিপোর্ট সম্পর্কে আরও জানতে কন্টেন্টের মালিকের রিপোর্ট সংক্রান্ত ডকুমেন্টেশন দেখুন।

    • নতুন কাজ করা মেট্রিক নিচে তালিকাভুক্ত করা হয়েছে। এইসব মেট্রিক কাজ করে এমন দুটি নতুন রিপোর্ট সহ রিপোর্ট শনাক্ত করার জন্য কন্টেন্টের মালিকের রিপোর্টের তালিকা আপডেট করা হয়েছে।

      • earnings – Google-এর বিক্রি করা সব বিজ্ঞাপন সোর্স থেকে সর্বমোট আনুমানিক উপার্জন।
      • grossRevenue – Google বা DoubleClick পার্টনারদের থেকে আনুমানিক মোট উপার্জন।
      • primaryAdGrossRevenue – Google বা DoubleClick পার্টনারদের থেকে, রিপোর্টের আওতাভুক্ত ভিডিও প্লেব্যাকের জন্য প্রাথমিক বিজ্ঞাপনের ধরন অনুযায়ী যোগ করা এবং শ্রেণীবদ্ধ করা আনুমানিক মোট উপার্জন।
      • monetizedPlaybacks – কমপক্ষে একটি বিজ্ঞাপনের ইম্প্রেশন দেখানো হয়েছে এমন প্লেব্যাকের সংখ্যা।
      • playbackBasedCpm – প্রতি হাজার প্লেব্যাক পিছু আনুমানিক মোট উপার্জন।
      • impressions – যাচাই করা বিজ্ঞাপনের ইম্প্রেশনের সংখ্যা।
      • impressionBasedCpm – প্রতি হাজার বিজ্ঞাপন ইম্প্রেশন পিছু আনুমানিক মোট উপার্জন।

      মনে রাখবেন: সম্পূর্ণ বিবরণের জন্য মেট্রিকের সংজ্ঞা দেখুন।

    • উপার্জন বা বিজ্ঞাপন সংক্রান্ত পারফর্ম্যান্স মেট্রিক্স রিট্রিভ করে এমন যেকোনও অনুরোধের ক্ষেত্রে অবশ্যই একটি অথরাইজেশন টোকেন পাঠাতে হবে যা নতুন https://www.googleapis.com/auth/yt-analytics-monetary.readonly স্কোপ ব্যবহার করে অ্যাক্সেস প্রদান করে।

  • API ডকুমেন্টেশন নতুন করে সাজানো হয়েছে যাতে বিভিন্ন ধরনের রিপোর্ট আলাদা আলাদা পৃষ্ঠায় ব্যাখ্যা করা যায়। সেই কারণে, এখন বিভিন্ন ধরনের চ্যানেল রিপোর্ট এবং কন্টেন্টের মালিকের রিপোর্ট ব্যাখ্যা করার জন্য আলাদা পৃষ্ঠা রয়েছে।

৪ ফেব্রুয়ারি, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API-এর রেফারেন্স গাইডে এখন একটি উদাহরণ বিভাগ রয়েছে, যার মধ্যে কোডের নমুনা রয়েছে যা Java, JavaScript, Python এবং Ruby ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কীভাবে API কল করতে হয় তা দেখায়। JavaScript কোডের স্যাম্পেলটি স্যাম্পেল অ্যাপ্লিকেশন ডকুমেন্টেশনে বিস্তারিতভাবে আলোচনা করা হয়েছে।

১৪ নভেম্বর, ২০১২

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • API রেফারেন্স গাইডে এখন APIs Explorer ফিচার রয়েছে, যা আপনাকে API কল করতে, API অনুরোধ দেখতে এবং উত্তরে আসল ডেটা ফিরিয়ে আনতে সাহায্য করে।

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

    • প্লেব্যাক লোকেশন রিপোর্ট থেকে বিভিন্ন ধরনের পৃষ্ঠা বা অ্যাপ্লিকেশনে কতবার ভিডিও দেখা হয়েছে তা জানা যায়।

    • প্লেব্যাক লোকেশন সংক্রান্ত বিস্তারিত রিপোর্ট থেকে নির্দিষ্ট ভিডিওর জন্য সবচেয়ে বেশি ভিউ জেনারেট করা এম্বেড করা প্লেয়ার শনাক্ত করা যায়। এটি সেরা এম্বেড করা প্লেয়ারের সাথে যুক্ত URL শনাক্ত করে প্লেব্যাক লোকেশন রিপোর্টের চেয়ে আরও সূক্ষ্ম ভিউ প্রদান করে।

    • ট্রাফিক সোর্স রিপোর্ট থেকে বিভিন্ন ধরনের রেফারার থেকে আসা ভিডিও ভিউয়ের সংখ্যা জানা যায়।

    • ট্রাফিক সোর্সের বিস্তারিত রিপোর্ট থেকে নির্দিষ্ট ভিডিও ও নির্দিষ্ট ট্রাফিক সোর্সের ধরনের জন্য সবচেয়ে বেশি ভিউ জেনারেট করা রেফারারকে শনাক্ত করা যায়। যেমন, এই রিপোর্ট থেকে আপনি জানতে পারবেন যে কোন সম্পর্কিত ভিডিও থেকে কোনও নির্দিষ্ট ভিডিওতে সবচেয়ে বেশি ট্রাফিক এসেছে। এই রিপোর্ট একাধিক ট্রাফিক সোর্সের জন্য কাজ করে।

    • দেখার সময়ের রিপোর্ট থেকে দর্শকরা আপনার কন্টেন্ট কতক্ষণ দেখেছেন তা জানা যায়। রিপোর্টগুলি নির্দিষ্ট সময়সীমার জন্য ডেটা একত্রিত করতে পারে – দিন, আগের সাত দিন, আগের ৩০ দিন ইত্যাদি – বা দেশ। কোনও রিপোর্ট যদি দিন বা দেশ অনুযায়ী ডেটা একত্রিত করে, তাহলে এটি প্রতিটি ভিডিও দেখার গড় দৈর্ঘ্যের পাশাপাশি ব্যবহারকারীদের দেখা প্রতিটি ভিডিওর গড় শতাংশও নির্দিষ্ট করতে পারে।

২ অক্টোবর, ২০১২

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

  • YouTube Analytics API এখন সব ডেভেলপারের জন্য উপলভ্য। আপনি APIs console-এর পরিষেবা প্যানেল থেকে, প্রথমে অ্যাক্সেসের অনুরোধ না করেই, আপনার প্রোজেক্টের জন্য API অ্যাক্টিভেট করতে পারবেন।

  • নতুন শুরু করা বিভাগে YouTube Analytics API ব্যবহার করে এমন একটি অ্যাপ্লিকেশন তৈরি করার জন্য পূর্বশর্ত এবং প্রাথমিক ধাপগুলি উল্লেখ করা হয়েছে।

১২ সেপ্টেম্বর, ২০১২

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:

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

  • টেম্পোরাল ডাইমেনশন বিভাগটি আপডেট করা হয়েছে যাতে ব্যাখ্যা করা যায় যে সেই ডাইমেনশনগুলি নির্দেশ করে যে Analytics রিপোর্টকে একটি নির্দিষ্ট সময়সীমার উপর ভিত্তি করে ডেটা একত্রিত করতে হবে। API এখন নিম্নলিখিত অতিরিক্ত টেম্পোরাল ডাইমেনশন সাপোর্ট করে:

    • 7DayTotals – রিপোর্টে ডেটা অ্যাগ্রিগেট করা হবে যাতে প্রতিটি সারিতে সাত দিনের ডেটা থাকে।
    • 30DayTotals – রিপোর্টের ডেটা এগ্রিগেট করা হবে যাতে প্রতিটি সারিতে ৩০ দিনের ডেটা থাকে।
    • month – রিপোর্টের ডেটা ক্যালেন্ডার মাস অনুযায়ী একত্রিত করা হবে।

    একইভাবে, উপলভ্য রিপোর্ট বিভাগটি আপডেট করা হয়েছে যাতে এই ডাইমেনশন ব্যবহার করে এমন রিপোর্টের জন্য API-এর সহায়তা প্রতিফলিত হয়।

  • রিপোর্টিং এন্টিটি ডাইমেনশন বিভাগটি আপডেট করা হয়েছে যাতে উল্লেখ করা হয় যে কন্টেন্টের মালিকের রিপোর্ট পেতে API অনুরোধগুলি অবশ্যই এই ডাইমেনশনগুলির মধ্যে একটি (video, channel, বা show) বা claimedStatus এবং uploaderType ডাইমেনশনের একটি সমর্থিত কম্বিনেশন ব্যবহার করে ডেটা ফিল্টার করতে হবে।

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

  • subscribersGained এবং subscribersLost মেট্রিকের সংজ্ঞা আপডেট করা হয়েছে যাতে এটি ব্যাখ্যা করা যায় যে ভিডিও দেখার পৃষ্ঠা, চ্যানেল পৃষ্ঠা এবং YouTube হোমপেজে দেখানো গাইড সহ বিভিন্ন জায়গায় কোনও চ্যানেল সাবস্ক্রাইবার পেতে বা হারাতে পারে। ভিডিও-নির্দিষ্ট রিপোর্টে এইসব মেট্রিক দেখানো হলে, নির্দিষ্ট ভিডিওর দেখার পৃষ্ঠা থেকে পাওয়া পরিসংখ্যানই শুধু এতে অন্তর্ভুক্ত থাকে।