এই পৃষ্ঠাটি YouTube রিপোর্টিং API এবং YouTube Analytics API উভয়ের জন্য API পরিবর্তন এবং ডকুমেন্টেশন আপডেটগুলি তালিকাভুক্ত করে৷ উভয় APIই ডেভেলপারদের YouTube অ্যানালিটিক্স ডেটা অ্যাক্সেস করতে সক্ষম করে, যদিও বিভিন্ন উপায়ে। এই চেঞ্জলগে সাবস্ক্রাইব করুন ।
15 নভেম্বর, 2024
দ্রষ্টব্য: নিম্নলিখিত পরিবর্তনটি 18 নভেম্বর, 2024 থেকে কার্যকর হবে৷
YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API ডকুমেন্টেশন আপডেট করা হয়েছে যে ট্র্যাফিক সোর্স রিপোর্টের জন্য, API-এর reports.query
পদ্ধতিটি এখন একটি ত্রুটি ফেরত দেয় যদি তারিখের পরিসরে # ক্যোয়ারী করা ভিডিওগুলির X # দিনের পণ্য 50,000 অতিক্রম করে। উদাহরণস্বরূপ, একটি প্রশ্ন যা 500টি ভিডিও আইডির জন্য ডেটা পুনরুদ্ধার করে সর্বোচ্চ 100 দিনের জন্য ডেটার জন্য অনুরোধ করতে পারে৷
এই পরিবর্তন চ্যানেল এবং বিষয়বস্তুর মালিক উভয়ের জন্য প্রতিবেদনকে প্রভাবিত করে।
একটি অনুরোধ ফেরত দেওয়া সারির সংখ্যা কমাতে, আপনার ক্যোয়ারীকে একাধিক ক্যোয়ারীতে বিভক্ত করুন যা কম ভিডিও নির্দিষ্ট করে বা ছোট তারিখের ব্যাপ্তি সেট করে। একটি নিয়ম হিসাবে, বড় ডেটা সেটের জন্য বাল্ক রিপোর্টের সুপারিশ করা হয়।
6 মে, 2024
ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই চ্যানেলের জন্য তিনটি নতুন প্রতিবেদন সমর্থন করে:
DMA রিপোর্ট দ্বারা ব্যবহারকারীর কার্যকলাপ হল একটি ভৌগলিক প্রতিবেদন যা নির্ধারিত বাজার এলাকা (DMA) দ্বারা ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে। এই রিপোর্টের জন্য, আপনাকে অবশ্যই
filters
প্যারামিটার মানcountry==US
এ সেট করতে হবে।একক লাইভ-স্ট্রিম করা ভিডিওর বিভিন্ন অংশের জন্য একযোগে দর্শকের সংখ্যা দেখায়।
সদস্য বাতিলকরণ রিপোর্ট পরিসংখ্যান প্রদান করে দেখায় কেন ব্যবহারকারীরা তাদের চ্যানেলের সদস্যপদ বাতিল করেছেন।
এই প্রতিবেদনটি নতুন
membershipsCancellationSurveyReason
ডাইমেনশন ব্যবহার করে, যা নির্দিষ্ট করে যে কেন একজন ব্যবহারকারী চ্যানেলের সদস্যতা বাতিল করেছেন। এটি নতুনmembershipsCancellationSurveyResponses
মেট্রিকও ব্যবহার করে, যা নির্দেশ করে যে সেই কারণে কতগুলি চ্যানেল মেম্বারশিপ বাতিল করা হয়েছে।
এছাড়াও, তিনটি নতুন মেট্রিক্স সমর্থন করার জন্য শ্রোতা ধরে রাখার প্রতিবেদনটি উন্নত করা হয়েছে:
7 এপ্রিল, 2024
ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই-এ বিষয়বস্তুর মালিকের প্লেলিস্ট রিপোর্ট সম্পর্কিত বেশ কিছু আপডেট রয়েছে। আপডেটগুলি চ্যানেল প্লেলিস্ট রিপোর্ট সম্পর্কিত আপডেটগুলির মতই, যা 19 জানুয়ারী, 2024-এ ঘোষণা করা হয়েছিল।
নিম্নলিখিত পুনর্বিবেচনা ইতিহাস এন্ট্রি 19 জানুয়ারী, 2024 এর এন্ট্রি হিসাবে প্রায় একই তথ্য প্রদান করে। মনে রাখবেন, তবে, বিষয়বস্তুর মালিক প্লেলিস্ট রিপোর্টগুলি 31 ডিসেম্বর, 2024 পর্যন্ত isCurated
ডাইমেনশনকে সমর্থন করবে, যখন মাত্রা চ্যানেল প্লেলিস্ট রিপোর্টের জন্য সমর্থিত হবে জুন ৩০, ২০২৪।
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
বিষয়বস্তুর মালিকের প্লেলিস্ট প্রতিবেদনের জন্য
isCurated
মাত্রাটি বাতিল করা হয়েছে। এটি 31 ডিসেম্বর, 2024-এ বা তার পরে আর সমর্থিত হবে না। সেই মাত্রার সংজ্ঞা সেই অনুযায়ী আপডেট করা হয়েছে।আপনি যখন
isCurated
ডাইমেনশন মুছে ফেলেন তখন পশ্চাদগামী সামঞ্জস্য রক্ষা করতে, শুধুমাত্র প্লেলিস্ট রিপোর্টের জন্যviews
মেট্রিকের পরিবর্তেplaylistViews
মেট্রিক পুনরুদ্ধার করতে আপনাকে অবশ্যই আপনার কোড আপডেট করতে হবে। যেহেতুviews
মেট্রিক এখনও প্লেলিস্ট রিপোর্টের জন্য সমর্থিত, ভিন্ন অর্থ সহ, আপনি মেট্রিক নাম আপডেট না করলে API এখনও ডেটা ফেরত দেবে। অবশ্যই, আপনিviews
এবংplaylistViews
উভয়ই পুনরুদ্ধার এবং প্রদর্শন করতে আপনার অ্যাপ্লিকেশন পরিবর্তন করতে পারেন।isCurated
মাত্রা ছাড়াও, নিম্নলিখিত API কার্যকারিতা নতুন প্রতিবেদনে আর সমর্থিত নয়:- নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য লোকেশন ফিল্টার, যেমন
continent
এবংsubcontinent
সমর্থিত নয়। -
redViews
এবংestimatedRedMinutesWatched
মেট্রিক্স নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য আর সমর্থিত নয়। এই মেট্রিকগুলি YouTube স্টুডিওতে উপলব্ধ নেই, তাই এই পরিবর্তনটি API কার্যকারিতাকে স্টুডিও অ্যাপ্লিকেশনে উপলব্ধ কার্যকারিতার সাথে সারিবদ্ধ করে। -
subscribedStatus
এবংyoutubeProduct
ডাইমেনশন আর চ্যানেল প্লেলিস্ট রিপোর্টের ফিল্টার হিসেবে সমর্থিত নয়। এই ফিল্টারগুলি YouTube স্টুডিওতে উপলব্ধ নেই, তাই এই পরিবর্তনটি API কার্যকারিতাকে স্টুডিও অ্যাপ্লিকেশনে উপলব্ধ কার্যকারিতার সাথে সারিবদ্ধ করে।
- নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য লোকেশন ফিল্টার, যেমন
প্লেলিস্ট রিপোর্টের জন্য সমর্থিত মেট্রিকগুলির প্রকারগুলিকে আরও পুঙ্খানুপুঙ্খভাবে ব্যাখ্যা করার জন্য সামগ্রীর মালিকের প্রতিবেদনের ডকুমেন্টেশনের প্লেলিস্ট প্রতিবেদন বিভাগটি আপডেট করা হয়েছে:
- একত্রিত ভিডিও মেট্রিকগুলি ব্যবহারকারীর কার্যকলাপ এবং ইম্প্রেশন মেট্রিক্স প্রদান করে যা সামগ্রীর মালিকের প্লেলিস্টের সমস্ত ভিডিওগুলির জন্য একত্রিত হয় যা সেই সামগ্রীর মালিকের মালিকানাধীন৷ সমষ্টিগত ভিডিও মেট্রিক্স শুধুমাত্র API অনুরোধের জন্য সমর্থিত যেগুলি
isCurated
মাত্রা ব্যবহার করে না। - ইন-প্লেলিস্ট মেট্রিক্স প্লেলিস্ট পৃষ্ঠার প্রসঙ্গে ব্যবহারকারীর কার্যকলাপ এবং ব্যস্ততা প্রতিফলিত করে। এই মেট্রিক্সগুলি প্লেলিস্টের অ-মালিকানাধীন ভিডিওগুলি থেকে ভিউ অন্তর্ভুক্ত করবে, তবে শুধুমাত্র যখন সেই ভিউগুলি প্লেলিস্টের প্রসঙ্গে ঘটেছে।
- সমর্থিত প্লেলিস্ট মেট্রিক্স বিভাগটি সমষ্টিগত ভিডিও মেট্রিক্স এবং প্লেলিস্টের মেট্রিক্স চিহ্নিত করে যা প্লেলিস্ট রিপোর্টের জন্য সমর্থিত।
- একত্রিত ভিডিও মেট্রিকগুলি ব্যবহারকারীর কার্যকলাপ এবং ইম্প্রেশন মেট্রিক্স প্রদান করে যা সামগ্রীর মালিকের প্লেলিস্টের সমস্ত ভিডিওগুলির জন্য একত্রিত হয় যা সেই সামগ্রীর মালিকের মালিকানাধীন৷ সমষ্টিগত ভিডিও মেট্রিক্স শুধুমাত্র API অনুরোধের জন্য সমর্থিত যেগুলি
নিম্নলিখিত নতুন ইন-প্লেলিস্ট মেট্রিক্স সামগ্রীর মালিকদের প্লেলিস্ট রিপোর্টের জন্য সমর্থিত। মনে রাখবেন যে এই মেট্রিকগুলি শুধুমাত্র তখনই সমর্থিত হয় যদি রিপোর্ট পুনরুদ্ধারের জন্য API অনুরোধটি
isCurated
মাত্রা ব্যবহার না করে। প্রতিটি মেট্রিকের সংজ্ঞার জন্য মেট্রিক্স ডকুমেন্টেশন দেখুন:views
মেট্রিকের আচরণ এখন নির্ভর করে যে API অনুরোধটি প্লেলিস্ট রিপোর্ট পুনরুদ্ধার করেছে তাisCurated
মাত্রা ব্যবহার করেছে কিনা:- যখন একটি অনুরোধে
isCurated
ডাইমেনশন অন্তর্ভুক্ত থাকে, তখনviews
মেট্রিক হল একটি ইন-প্লেলিস্ট মেট্রিক যা কন্টেন্ট মালিকের প্লেলিস্টের পরিপ্রেক্ষিতে ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দেশ করে। - যখন কোনো অনুরোধে
isCurated
ডাইমেনশন অন্তর্ভুক্ত করা হয় না,views
মেট্রিক হল একটি সমষ্টিগত ভিডিও মেট্রিক যা কন্টেন্ট মালিকের প্লেলিস্টের ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দিষ্ট করে, সেই ভিউ প্লেলিস্টের প্রেক্ষাপটে ঘটেছে কিনা তা নির্বিশেষে। সমষ্টিগত টোটালে শুধুমাত্র সেই ভিডিওগুলির ভিউ অন্তর্ভুক্ত থাকে যা প্লেলিস্টের মালিক চ্যানেলের সাথে সংশ্লিষ্ট বিষয়বস্তুর মালিকের মালিকানাধীন।
এই রিপোর্টগুলিতে, যেগুলিisCurated
মাত্রা ব্যবহার করে না,playlistViews
মেট্রিক প্লেলিস্ট প্রসঙ্গে ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দেশ করে৷ সেই মেট্রিকটি প্লেলিস্টের সমস্ত ভিডিওর ভিউ গণনা করে, তা নির্বিশেষে কোন চ্যানেলের মালিকানা তাদের।
- যখন একটি অনুরোধে
প্রতিটি প্লেলিস্ট রিপোর্টের জন্য, বিষয়বস্তুর মালিকের রিপোর্ট ডকুমেন্টেশন এখন সেই রিপোর্টের জন্য সমর্থিত মেট্রিক্স দেখানো সারণীগুলিকে অন্তর্ভুক্ত করে যা API অনুরোধটি
isCurated
মাত্রা অন্তর্ভুক্ত করে কিনা তার উপর নির্ভর করে। উদাহরণের জন্য সময়-ভিত্তিক প্লেলিস্ট রিপোর্ট সংজ্ঞায়িত বিভাগটি পড়ুন।
জানুয়ারী 19, 2024
ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই-এ চ্যানেল প্লেলিস্ট রিপোর্ট সম্পর্কিত বেশ কিছু আপডেট রয়েছে। আপডেটগুলির মধ্যে একটি অপ্রচলিত মাত্রা এবং বেশ কয়েকটি নতুন এবং আপডেট হওয়া মেট্রিক্স রয়েছে:
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
চ্যানেল রিপোর্টের জন্য
isCurated
ডাইমেনশন বাতিল করা হয়েছে। এটি 30 জুন, 2024-এ বা তার পরে আর সমর্থিত হবে না। সেই মাত্রার সংজ্ঞা সেই অনুযায়ী আপডেট করা হয়েছে।আপনি যখন
isCurated
ডাইমেনশন মুছে ফেলেন তখন পশ্চাদগামী সামঞ্জস্য রক্ষা করতে, শুধুমাত্র প্লেলিস্ট রিপোর্টের জন্যviews
মেট্রিকের পরিবর্তেplaylistViews
মেট্রিক পুনরুদ্ধার করতে আপনাকে অবশ্যই আপনার কোড আপডেট করতে হবে। যেহেতুviews
মেট্রিক এখনও প্লেলিস্ট রিপোর্টের জন্য সমর্থিত, ভিন্ন অর্থ সহ, আপনি মেট্রিক নাম আপডেট না করলে API এখনও ডেটা ফেরত দেবে। অবশ্যই, আপনিviews
এবংplaylistViews
উভয়ই পুনরুদ্ধার এবং প্রদর্শন করতে আপনার অ্যাপ্লিকেশন পরিবর্তন করতে পারেন।isCurated
মাত্রা ছাড়াও, নিম্নলিখিত API কার্যকারিতা নতুন প্রতিবেদনে আর সমর্থিত নয়:- নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য লোকেশন ফিল্টার, যেমন
continent
এবংsubcontinent
সমর্থিত নয়। -
redViews
এবংestimatedRedMinutesWatched
মেট্রিক্স নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য আর সমর্থিত নয়। এই মেট্রিকগুলি YouTube স্টুডিওতে উপলব্ধ নেই, তাই এই পরিবর্তনটি API কার্যকারিতাকে স্টুডিও অ্যাপ্লিকেশনে উপলব্ধ কার্যকারিতার সাথে সারিবদ্ধ করে। -
subscribedStatus
এবংyoutubeProduct
ডাইমেনশন আর চ্যানেল প্লেলিস্ট রিপোর্টের ফিল্টার হিসেবে সমর্থিত নয়। এই ফিল্টারগুলি YouTube স্টুডিওতে উপলব্ধ নেই, তাই এই পরিবর্তনটি API কার্যকারিতাকে স্টুডিও অ্যাপ্লিকেশনে উপলব্ধ কার্যকারিতার সাথে সারিবদ্ধ করে।
- নতুন চ্যানেল প্লেলিস্ট রিপোর্টের জন্য লোকেশন ফিল্টার, যেমন
চ্যানেল রিপোর্ট ডকুমেন্টেশনের প্লেলিস্ট রিপোর্ট বিভাগ আপডেট করা হয়েছে প্লেলিস্ট রিপোর্টের জন্য সমর্থিত মেট্রিক্সের ধরনগুলিকে আরও পুঙ্খানুপুঙ্খভাবে ব্যাখ্যা করার জন্য:
- একত্রিত ভিডিও মেট্রিক্স ব্যবহারকারীর কার্যকলাপ এবং ইম্প্রেশন মেট্রিক্স প্রদান করে যা চ্যানেলের প্লেলিস্টের সমস্ত ভিডিওর জন্য একত্রিত করা হয় যা সেই চ্যানেলের মালিকানাধীন। সমষ্টিগত ভিডিও মেট্রিক্স শুধুমাত্র API অনুরোধের জন্য সমর্থিত যেগুলি
isCurated
মাত্রা ব্যবহার করে না। - ইন-প্লেলিস্ট মেট্রিক্স প্লেলিস্ট পৃষ্ঠার প্রসঙ্গে ব্যবহারকারীর কার্যকলাপ এবং ব্যস্ততা প্রতিফলিত করে। এই মেট্রিক্সগুলি প্লেলিস্টের অ-মালিকানাধীন ভিডিওগুলি থেকে ভিউ অন্তর্ভুক্ত করবে, তবে শুধুমাত্র যখন সেই ভিউগুলি প্লেলিস্টের প্রসঙ্গে ঘটেছে।
- সমর্থিত প্লেলিস্ট মেট্রিক্স বিভাগটি সমষ্টিগত ভিডিও মেট্রিক্স এবং ইন-প্লেলিস্ট মেট্রিক্স চিহ্নিত করে যা প্লেলিস্ট রিপোর্টের জন্য সমর্থিত।
- একত্রিত ভিডিও মেট্রিক্স ব্যবহারকারীর কার্যকলাপ এবং ইম্প্রেশন মেট্রিক্স প্রদান করে যা চ্যানেলের প্লেলিস্টের সমস্ত ভিডিওর জন্য একত্রিত করা হয় যা সেই চ্যানেলের মালিকানাধীন। সমষ্টিগত ভিডিও মেট্রিক্স শুধুমাত্র API অনুরোধের জন্য সমর্থিত যেগুলি
নিম্নলিখিত নতুন ইন-প্লেলিস্ট মেট্রিকগুলি চ্যানেলগুলির প্লেলিস্ট রিপোর্টগুলির জন্য সমর্থিত৷ এই মেট্রিকগুলি এখনও সামগ্রীর মালিকের প্রতিবেদনের জন্য সমর্থিত নয়৷ মনে রাখবেন যে এই মেট্রিকগুলি শুধুমাত্র তখনই সমর্থিত হয় যদি রিপোর্ট পুনরুদ্ধারের জন্য API অনুরোধটি
isCurated
মাত্রা ব্যবহার না করে। প্রতিটি মেট্রিকের সংজ্ঞার জন্য মেট্রিক্স ডকুমেন্টেশন দেখুন:views
মেট্রিকের আচরণ এখন নির্ভর করে যে API অনুরোধটি প্লেলিস্ট রিপোর্ট পুনরুদ্ধার করেছে তাisCurated
মাত্রা ব্যবহার করেছে কিনা:- যখন একটি অনুরোধে
isCurated
মাত্রা অন্তর্ভুক্ত থাকে,views
মেট্রিক হল একটি ইন-প্লেলিস্ট মেট্রিক যা চ্যানেলের প্লেলিস্টের পরিপ্রেক্ষিতে ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দেশ করে৷ - যখন কোনো অনুরোধে
isCurated
ডাইমেনশন অন্তর্ভুক্ত করা হয় না, তখনviews
মেট্রিক হল একটি সমষ্টিগত ভিডিও মেট্রিক যা চ্যানেলের প্লেলিস্টে থাকা ভিডিওটি কতবার দেখা হয়েছে তা নির্দিষ্ট করে, সেই ভিউ প্লেলিস্টের প্রেক্ষাপটে ঘটেছে কিনা তা নির্বিশেষে। সমষ্টিগত টোটালে শুধুমাত্র সেই ভিডিওগুলির ভিউ অন্তর্ভুক্ত থাকে যা প্লেলিস্টের মালিক চ্যানেলের মালিকানাধীন।
এই রিপোর্টগুলিতে, যেগুলিisCurated
মাত্রা ব্যবহার করে না,playlistViews
মেট্রিক প্লেলিস্ট প্রসঙ্গে ভিডিওগুলি কতবার দেখা হয়েছে তা নির্দেশ করে৷ সেই মেট্রিকটি প্লেলিস্টের সমস্ত ভিডিওর ভিউ গণনা করে, তা নির্বিশেষে কোন চ্যানেলের মালিকানা তাদের।
- যখন একটি অনুরোধে
প্রতিটি প্লেলিস্ট রিপোর্টের জন্য, চ্যানেল রিপোর্ট ডকুমেন্টেশনে এখন সেই রিপোর্টের জন্য সমর্থিত মেট্রিক্স দেখানো সারণী অন্তর্ভুক্ত থাকে যা API অনুরোধে
isCurated
মাত্রা অন্তর্ভুক্ত করে কিনা তার উপর নির্ভর করে। উদাহরণের জন্য সময়-ভিত্তিক প্লেলিস্ট রিপোর্ট সংজ্ঞায়িত বিভাগটি পড়ুন।
ডিসেম্বর 04, 2023
ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API দুটি insightTrafficSourceType
টাইপ মাত্রা মান একত্রিত করতে আপডেট করা হয়েছে৷ পূর্বে, একটি প্লেলিস্ট ( PLAYLIST
) এর অংশ হিসাবে বাজানো ভিডিও এবং একটি প্লেলিস্ট ( YT_PLAYLIST_PAGE
) এর সমস্ত ভিডিও তালিকাভুক্ত একটি পৃষ্ঠা থেকে উদ্ভূত ভিউগুলির মধ্যে মাত্রা পার্থক্য করত৷ সামনের দিকে, উভয় ধরনের ভিউই PLAYLIST
মাত্রা মানের সাথে যুক্ত হবে।
15 ডিসেম্বর, 2022
YouTube Analytics (টার্গেটেড কোয়েরি) API দুটি নতুন মাত্রা এবং একটি নতুন প্রতিবেদন সমর্থন করে:
একটি নতুন প্রতিবেদন শহর অনুসারে ব্যবহারকারীর কার্যকলাপ প্রদান করে। এই প্রতিবেদনটি চ্যানেল এবং বিষয়বস্তুর মালিকদের জন্য উপলব্ধ। এই প্রতিবেদনে নতুন
city
মাত্রা রয়েছে, যা ব্যবহারকারীর কার্যকলাপ যেখানে হয়েছিল সেই শহরের সম্পর্কে YouTube-এর অনুমান শনাক্ত করে৷নতুন
creatorContentType
ডাইমেনশন YouTube কন্টেন্টের ধরন শনাক্ত করে যা ডেটা সারিতে ব্যবহারকারীর অ্যাক্টিভিটি মেট্রিক্সের সাথে যুক্ত। সমর্থিত মানগুলি হলLIVE_STREAM
,SHORTS
,STORY
, এবংVIDEO_ON_DEMAND
৷creatorContentType
মাত্রা সমস্ত চ্যানেল এবং বিষয়বস্তুর মালিক ভিডিও রিপোর্টের জন্য একটি ঐচ্ছিক মাত্রা হিসাবে সমর্থিত।ইউটিউব অ্যানালিটিক্স এপিআই নমুনা অনুরোধ নির্দেশিকাতে এখন উভয় নতুন মাত্রার উদাহরণ রয়েছে।
ডকুমেন্টেশন থেকে
7DayTotals
এবং30DayTotals
মাত্রার উল্লেখ মুছে ফেলা হয়েছে। এই মাত্রাগুলির অবচয় অক্টোবর 2019 এ ঘোষণা করা হয়েছিল।
আগস্ট 26, 2022
ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই এবং ইউটিউব রিপোর্টিং (বাল্ক রিপোর্ট) এপিআই উভয়ই একটি নতুন ট্রাফিক সোর্স বিশদ মান সমর্থন করে:
- YouTube Analytics API (টার্গেটেড কোয়েরি) API-এ, যদি
insightTrafficSourceType
টাইপ মাত্রার মানSUBSCRIBER
হয়, তাহলেinsightTrafficSourceDetail
মানpodcasts
সেট করা যেতে পারে, যা নির্দেশ করে যে ট্র্যাফিকটি পডকাস্টের গন্তব্য পৃষ্ঠা থেকে উল্লেখ করা হয়েছে৷ - YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API-এ, যদি
traffic_source_type
ডাইমেনশনের মান3
হয়, তাহলেtraffic_source_detail
মানpodcasts
সেট করা যেতে পারে, যা নির্দেশ করে যে ট্র্যাফিকটি পডকাস্টের গন্তব্য পৃষ্ঠা থেকে উল্লেখ করা হয়েছে।
11 ফেব্রুয়ারি, 2022
gender
মাত্রার জন্য বৈধ মানগুলির সেট 11 আগস্ট, 2022 তারিখে বা তার পরে পরিবর্তিত হবে। এটি আপনার API বাস্তবায়নে একটি পিছিয়ে-বেমানান পরিবর্তন হতে পারে। YouTube API পরিষেবার পরিষেবার শর্তাবলীর ব্যাকওয়ার্ড ইনকম্প্যাটিবল পরিবর্তন বিভাগ অনুসারে, এই পরিবর্তনটি কার্যকর হওয়ার ছয় মাস আগে ঘোষণা করা হচ্ছে৷ অনুগ্রহ করে 11 অগাস্ট, 2022-এর আগে আপনার API বাস্তবায়ন আপডেট করুন, যাতে নতুন মানগুলির একটি নিরবিচ্ছিন্ন পরিবর্তন নিশ্চিত করা যায়।
নির্দিষ্ট পরিবর্তনগুলি হল:
- ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-এ,
gender
মাত্রা বর্তমানে দুটি মান সমর্থন করে:female
এবংmale
। 11 আগস্ট, 2022-এ বা তার পরে, সেই মাত্রা তিনটি মানকে সমর্থন করবে:female
,male
, এবংuser_specified
৷ - YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API-এ,
gender
মাত্রা বর্তমানে তিনটি মান সমর্থন করে:FEMALE
,MALE
, এবংGENDER_OTHER
৷ 11 আগস্ট, 2022-এ বা তার পরে, সমর্থিত মানগুলির সেটটিFEMALE
,MALE
এবংUSER_SPECIFIED
এ পরিবর্তিত হবে৷
ফেব্রুয়ারী 9, 2022
13 ডিসেম্বর, 2021 থেকে লুপিং ক্লিপ ট্রাফিক বাদ দিতে দুটি মেট্রিক আপডেট করা হয়েছে। এই পরিবর্তনটি YouTube Analytics (টার্গেটেড কোয়েরি) API এবং YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API উভয়কেই প্রভাবিত করে।
- ইউটিউব অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই-এ, 13 ডিসেম্বর, 2021 থেকে
averageViewDuration
এবংaverageViewPercentage
মেট্রিক্স উভয়ই লুপিং ক্লিপ ট্রাফিক বাদ দেয়। - YouTube রিপোর্টিং (বাল্ক রিপোর্ট) এপিআই-এ,
average_view_duration_seconds
এবংaverage_view_duration_percentage
মেট্রিক্স উভয়ই 13 ডিসেম্বর, 2021 পর্যন্ত লুপিং ক্লিপ ট্রাফিক বাদ দেয়।
2 ফেব্রুয়ারি, 2022
এই YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API একটি নতুন ট্রাফিক সোর্স ডাইমেনশন মানকে সমর্থন করে যা নির্দেশ করে যে ভিউগুলি লাইভ রিডাইরেক্ট থেকে এসেছে :
- YouTube রিপোর্টিং (বাল্ক রিপোর্ট) এপিআই-এ,
traffic_source_type
ডাইমেনশন28
মানকে সমর্থন করে।
এই ট্রাফিক সোর্স টাইপের জন্য, traffic_source_detail
ডাইমেনশন সেই চ্যানেল আইডি নির্দিষ্ট করে যেখান থেকে দর্শককে রেফার করা হয়েছে।
23 সেপ্টেম্বর, 2020
এই YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই এবং ইউটিউব রিপোর্টিং (বাল্ক রিপোর্ট) এপিআই উভয়ই একটি নতুন ট্রাফিক সোর্স ডাইমেনশন মানকে সমর্থন করে যা নির্দেশ করে যে YouTube Shorts দেখার অভিজ্ঞতায় উল্লম্বভাবে সোয়াইপ করার মাধ্যমে দর্শককে রেফার করা হয়েছে:
- YouTube Analytics API (টার্গেটেড কোয়েরি) API-এ,
insightTrafficSourceType
টাইপ মাত্রাSHORTS
মান সমর্থন করে। - YouTube রিপোর্টিং (বাল্ক রিপোর্ট) এপিআই-এ,
traffic_source_type
ডাইমেনশন24
মানকে সমর্থন করে।
ট্রাফিক সোর্স ডিটেইল ডাইমেনশন — YouTube Analytics API-এ insightTrafficSourceDetail
বা YouTube রিপোর্টিং API-এ traffic_source_detail
— এই নতুন ট্রাফিক সোর্স ধরনের জন্য পপুলেট করা হয়নি।
20 জুলাই, 2020
এই আপডেটটি দুটি পরিবর্তন কভার করে যা YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআইকে প্রভাবিত করে:
- একটি YouTube অ্যানালিটিক্স রিপোর্টিং গোষ্ঠীর সর্বাধিক আকার 200 থেকে 500টি সত্তায় বৃদ্ধি পেয়েছে৷
-
reports.query
পদ্ধতিরfilters
প্যারামিটার ফিল্টারের একটি তালিকা চিহ্নিত করে যা YouTube Analytics ডেটা পুনরুদ্ধার করার সময় প্রয়োগ করা উচিত। প্যারামিটারটিvideo
,playlist
এবংchannel
ফিল্টারগুলির জন্য একাধিক মান নির্দিষ্ট করার ক্ষমতাকে সমর্থন করে এবং সেই ফিল্টারগুলির জন্য নির্দিষ্ট করা যেতে পারে এমন সর্বাধিক সংখ্যা 200 থেকে 500 আইডিতে বৃদ্ধি পেয়েছে৷
13 ফেব্রুয়ারি, 2020
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) এপিআই এবং ইউটিউব রিপোর্টিং (বাল্ক রিপোর্ট) এপিআই সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে৷ আপনি YouTube সহায়তা কেন্দ্রে এই পরিবর্তনগুলি সম্পর্কে আরও জানতে পারেন৷
উভয় API-এ, বিজ্ঞপ্তিগুলির জন্য সম্ভাব্য ট্রাফিক উৎসের বিশদ মানগুলির সেট পরিবর্তিত হচ্ছে৷ টার্গেট করা প্রশ্নে , বিজ্ঞপ্তিগুলি insightTrafficSourceType=NOTIFICATION
হিসাবে রিপোর্ট করা হয়। বাল্ক রিপোর্টে , বিজ্ঞপ্তিগুলিকে traffic_source_type=17
হিসাবে রিপোর্ট করা হয়।
নতুন মানগুলি আপলোড করা ভিডিও এবং লাইভ স্ট্রীম সম্পর্কিত বিজ্ঞপ্তিগুলিকে বিভক্ত করেছে, পূর্বে uploaded
হিসাবে রিপোর্ট করা হয়েছে, দুটি বিভাগে:
-
uploaded_push
- ভিডিও আপলোড করার সময় সাবস্ক্রাইবারদের পাঠানো পুশ নোটিফিকেশন থেকে ভিউ এসেছে -
uploaded_other
- ভিডিও আপলোড করার সময় সদস্যদের কাছে পাঠানো ইমেল বা ইনবক্স বিজ্ঞপ্তির মতো নন-পুশ নোটিফিকেশন থেকে ভিউ এসেছে।
এই মানগুলি 2020-01-13 (13 জানুয়ারী, 2020) থেকে শুরু হওয়া সময়ের জন্য ফেরত দেওয়া হয়।
এছাড়াও, একটি অনুস্মারক হিসাবে, এই মানগুলি নিজেরাই বিজ্ঞপ্তিগুলিকে প্রতিনিধিত্ব করে না, বরং ট্র্যাফিক উত্সগুলি যা নির্দিষ্ট YouTube দর্শনগুলিকে চালিত করে৷ উদাহরণস্বরূপ, যদি একটি প্রতিবেদনের সারি দেখায় views=3
, traffic_source_type=17
( NOTIFICATION
), এবং traffic_source_detail=uploaded_push
, সারিটি নির্দেশ করে যে ভিডিওটি আপলোড করার সময় প্রেরিত পুশ বিজ্ঞপ্তিতে ক্লিক করার ফলে দর্শকরা তিনটি ভিউ পেয়েছেন৷
15 অক্টোবর, 2019
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-এর সাথে সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
YouTube
7DayTotals
এবং30DayTotals
মাত্রার জন্য সমর্থন সরিয়ে দিচ্ছে৷ আপনি এখনও 15 এপ্রিল, 2020 পর্যন্ত সেই মাত্রাগুলি ব্যবহার করে ডেটা পুনরুদ্ধার করতে পারবেন। সেই তারিখে বা তার পরে,7DayTotals
বা30DayTotals
ডাইমেনশন ব্যবহার করে রিপোর্ট পুনরুদ্ধার করার চেষ্টা করলে একটি ত্রুটি দেখাবে।নোট করুন যে ব্যবহারকারীরা
day
মাত্রা ব্যবহার করে অনুসন্ধান করে এবং সাত- বা 30- দিনের সময়সীমা জুড়ে ডেটা একত্রিত বা আহরণ করে এই মাত্রাগুলির জন্য কিছু ডেটা পুনরুত্পাদন করতে পারে। যেমন:- একটি সাত দিনের সময়কালের ভিউ সংখ্যা সেই সময়ের প্রতিটি দিনের ভিউ সংখ্যা একত্রিত করে গণনা করা যেতে পারে।
- সেই দিন ভিডিওটি দেখার সময় লগ ইন করা দর্শকের সংখ্যা পেতে সাত দিনের সময়ের জন্য ভিউয়ার পারসেন্টেজ গণনা করা যেতে পারে যেটি প্রতিদিন ঘটেছিল সেই দিনের ভিউয়ার পারসেন্টেজকে গুণ করে। তারপরে, পুরো সময়ের জন্য লগ-ইন করা দর্শকের সংখ্যা যোগ করা যেতে পারে এবং সেই সময়ের জন্য ভিউয়ের মোট সংখ্যা দিয়ে ভাগ করে পুরো সময়ের জন্য ভিউয়ার পারসেন্টেজ পেতে পারেন।
- সাত দিনের সময়ের জন্য অনন্য দর্শকের সংখ্যা গণনা করা যায় না কারণ একই দর্শককে বিভিন্ন দিনে অনন্য দর্শক হিসাবে গণনা করা যেতে পারে। যাইহোক, আপনি 30-দিনের সময়কালে অনন্য দর্শকের সংখ্যা সম্পর্কে ডেটা এক্সট্রাপোলেট করতে
30DayTotals
মাত্রার পরিবর্তেmonth
মাত্রা ব্যবহার করতে সক্ষম হতে পারেন। মনে রাখবেন যেmonth
মাত্রাটি ক্যালেন্ডার মাসগুলিকে বোঝায় যেখানে30DayTotals
মাত্রা নির্দিষ্ট শুরু এবং শেষ তারিখের উপর ভিত্তি করে 30-দিনের সময়কাল গণনা করে৷
জুন 27, 2019
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-এর সাথে সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
যেহেতু API এর সংস্করণ 1 এখন সম্পূর্ণরূপে অবহেলিত হয়েছে, ডকুমেন্টেশনটি সেই সংস্করণের রেফারেন্সগুলি সরাতে আপডেট করা হয়েছে, যার মধ্যে অবচয় বিজ্ঞপ্তি এবং মাইগ্রেশন গাইড ব্যাখ্যা করা হয়েছে যে সংস্করণ 2-এ কীভাবে আপডেট করা যায়।
নভেম্বর 1, 2018
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-এর সাথে সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
API-এর সংস্করণ 1 এখন অবহেলিত। যদি আপনি ইতিমধ্যে এটি না করে থাকেন, তাহলে পরিষেবার ব্যাঘাত কমাতে যত তাড়াতাড়ি সম্ভব API-এর সংস্করণ 2 ব্যবহার করতে আপনার API ক্লায়েন্টদের আপডেট করুন। আরো বিস্তারিত জানার জন্য মাইগ্রেশন গাইড দেখুন।
মনে রাখবেন যে এই অবমূল্যায়নের সময়সূচী মূলত 26 এপ্রিল, 2018- এ ঘোষণা করা হয়েছিল।
সেপ্টেম্বর 17, 2018
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-এর সাথে সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ডেটা মডেল ওভারভিউ ডকুমেন্টের নতুন ডেটা বেনামীকরণ বিভাগটি ব্যাখ্যা করে যে কিছু YouTube Analytics ডেটা সীমিত থাকে যখন মেট্রিক্স একটি নির্দিষ্ট থ্রেশহোল্ড পূরণ করে না। এটি বিভিন্ন ক্ষেত্রে ঘটতে পারে। বাস্তবে, এর মানে হল যে একটি রিপোর্টে আপনার সমস্ত ডেটা (বা যেকোনো) নাও থাকতে পারে যদি:
একটি নির্দিষ্ট সময়ের মধ্যে একটি ভিডিও বা চ্যানেলে সীমিত ট্রাফিক আছে,
বা
আপনি একটি ফিল্টার বা মাত্রা নির্বাচন করেছেন, যেমন ট্রাফিক উৎস বা দেশ, যার মান একটি নির্দিষ্ট থ্রেশহোল্ড পূরণ করে না।
নতুন বিভাগে ইউটিউব অ্যানালিটিক্স রিপোর্টে সীমিত হতে পারে এমন ডেটার ধরনের আলোচনাও রয়েছে।
চ্যানেল রিপোর্ট এবং বিষয়বস্তুর মালিকের প্রতিবেদনের নথিগুলি এই সত্যটি প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে
redViews
এবংestimatedRedMinutesWatched
মেট্রিক্সগুলি আর প্লেব্যাক অবস্থান, ট্র্যাফিক উত্স এবং ডিভাইসের ধরন/অপারেটিং সিস্টেম রিপোর্টের জন্য সমর্থিত নয়৷
18 জুন, 2018
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) 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
সুযোগ
প্রথম বিকল্পটি একটি সুযোগ ব্যবহার করে, যা একটি পঠন-লেখার সুযোগ হিসাবে ঘটে, যখন দ্বিতীয় বিকল্পটি দুটি শুধুমাত্র-পঠন স্কোপ ব্যবহার করে।
-
-
23 মে, 2018
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-তে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
- API ওভারভিউতে একটি নতুন বিভাগ, সমষ্টিগত মেট্রিক্স এবং মুছে ফেলা আইটেম রয়েছে, যা ব্যাখ্যা করে কিভাবে API প্রতিক্রিয়াগুলি মুছে ফেলা সংস্থানগুলির সাথে সম্পর্কিত ডেটা পরিচালনা করে, যেমন ভিডিও, প্লেলিস্ট বা চ্যানেল৷
- API ওভারভিউ-এর সর্বোত্তম অনুশীলন বিভাগটি আপনাকে মনে করিয়ে দেওয়ার জন্য আপডেট করা হয়েছে যে আপনি YouTube Analytics API প্রতিক্রিয়াগুলিতে চিহ্নিত সংস্থানগুলির জন্য অতিরিক্ত মেটাডেটা পুনরুদ্ধার করতে YouTube ডেটা API ব্যবহার করতে পারেন৷ YouTube API পরিষেবা বিকাশকারী নীতিগুলিতে উল্লিখিত হিসাবে (বিভাগ III.E.4.b থেকে III.E.4.d), API ক্লায়েন্টদের অবশ্যই 30 দিন পরে সেই API থেকে সঞ্চিত সংস্থান মেটাডেটা মুছতে হবে বা রিফ্রেশ করতে হবে।
22 মে, 2018
এই আপডেটে YouTube রিপোর্টিং (বাল্ক রিপোর্ট) API এর সাথে সম্পর্কিত নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
- নিম্নলিখিত পরিবর্তনগুলি বর্তমানে জুলাই 2018 এ কার্যকর হওয়ার জন্য নির্ধারিত হয়েছে, এবং নতুন নীতিগুলি সমস্ত রিপোর্ট এবং রিপোর্টিং চাকরিতে বিশ্বব্যাপী প্রযোজ্য হবে৷
পরিবর্তনের পরে, ব্যাকফিল রিপোর্ট সহ বেশিরভাগ API রিপোর্টগুলি তৈরি হওয়ার সময় থেকে 60 দিনের জন্য উপলব্ধ থাকবে৷ যাইহোক, ঐতিহাসিক তথ্য সম্বলিত প্রতিবেদনগুলি তৈরি হওয়ার সময় থেকে 30 দিনের জন্য উপলব্ধ থাকবে৷
এই ঘোষণার আগে, সমস্ত API রিপোর্ট তৈরি হওয়ার সময় থেকে 180 দিনের জন্য উপলব্ধ ছিল। স্পষ্ট করে বলতে গেলে, এই নীতি পরিবর্তন কার্যকর হলে, 30 দিনের বেশি পুরানো ঐতিহাসিক ডেটা রিপোর্টগুলিও আর API-এর মাধ্যমে অ্যাক্সেসযোগ্য হবে না। 60 দিনের বেশি পুরানো অন্যান্য সমস্ত রিপোর্টও আর অ্যাক্সেসযোগ্য হবে না। যেমন, ডকুমেন্টেশনে এখন বলা হয়েছে যে নীতি পরিবর্তনের আগে তৈরি করা রিপোর্ট 180 দিন পর্যন্ত পাওয়া যাবে।
পরিবর্তনের পরে, আপনি যখন একটি রিপোর্টিং কাজের সময়সূচী করবেন, তখন YouTube সেই দিন থেকে রিপোর্ট তৈরি করবে এবং কাজের সময় নির্ধারণের আগে 30-দিনের সময়সীমাকে কভার করবে৷ পরিবর্তনের আগে, আপনি যখন একটি রিপোর্টিং কাজের সময়সূচী করেন, তখন YouTube সেই কাজের সময় নির্ধারণের আগে 180-দিনের সময়সীমাকে কভার করে প্রতিবেদন তৈরি করবে।
আপনাকে মনে করিয়ে দেওয়ার জন্য সেরা অনুশীলন বিভাগটি আপডেট করা হয়েছে যে আপনি প্রতিবেদনে চিহ্নিত সংস্থানগুলির জন্য অতিরিক্ত মেটাডেটা পুনরুদ্ধার করতে YouTube ডেটা API ব্যবহার করতে পারেন৷ YouTube API পরিষেবা বিকাশকারী নীতিগুলিতে উল্লিখিত হিসাবে (বিভাগ III.E.4.b থেকে III.E.4.d), API ক্লায়েন্টদের অবশ্যই 30 দিন পরে সেই API থেকে সঞ্চিত সংস্থান মেটাডেটা মুছতে হবে বা রিফ্রেশ করতে হবে।
প্রতিবেদনের বৈশিষ্ট্য বিভাগটি নোট করার জন্য আপডেট করা হয়েছে যে যদিও প্রতিবেদনের ডেটা ফিল্টার করা হয়নি, যে রিপোর্টগুলিতে 1 জুন, 2018 বা তার পরে একটি সময়ের জন্য ডেটা রয়েছে, তাতে YouTube সংস্থানগুলির কোনও উল্লেখ থাকবে না যা কমপক্ষে 30 দিন আগে মুছে ফেলা হয়েছিল রিপোর্ট তৈরি হওয়ার তারিখ পর্যন্ত।
এপিআই ওভারভিউ-এর ঐতিহাসিক ডেটা বিভাগটি নোট করার জন্য আপডেট করা হয়েছে যে আপনি যখন একটি নতুন রিপোর্টিং কাজের সময় নির্ধারণ করেন, তখন ঐতিহাসিক প্রতিবেদনগুলি সাধারণত কয়েক দিনের মধ্যে পোস্ট করা হয়। পূর্বে, ডকুমেন্টেশনে বলা হয়েছিল যে এই ধরনের প্রতিবেদনগুলি উপলব্ধ হতে 30 দিন পর্যন্ত সময় লাগতে পারে।
এপিআই ওভারভিউ-এর ব্যাকফিল ডেটা বিভাগটিকে আরও স্পষ্টভাবে ব্যাকফিল ডেটাকে ডেটা সেট হিসাবে সংজ্ঞায়িত করার জন্য আপডেট করা হয়েছে যা পূর্বে বিতরণ করা সেটকে প্রতিস্থাপন করে।
এপ্রিল 26, 2018
YouTube Analytics (টার্গেটেড কোয়েরি) API (v2) এর সংস্করণ 2 এখন সর্বজনীনভাবে উপলব্ধ৷ নিম্নলিখিত তালিকাটি নতুন 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
ব্যবহার করতে হবে।
এছাড়াও, কয়েকটি v1 বৈশিষ্ট্য v2 API-তে সমর্থিত নয়:
-
reports.query
পদ্ধতিটি আরalt
,quotaUser
, এবংuserIp
অনুরোধের পরামিতি সমর্থন করে না৷ - v2 API একটি ব্যাচ এন্ডপয়েন্ট প্রদান করে না যা বিভিন্ন API-এর অনুরোধের সমন্বিত ব্যাচগুলিকে সমর্থন করে। (একটি ব্যাচ একই API-এর বিভিন্ন পদ্ধতির অনুরোধের সমন্বয়ে গঠিত হতে পারে।) এই অবচয় YouTube Analytics API-এর জন্য নির্দিষ্ট নয় কারণ Google তার সমস্ত API জুড়ে গ্লোবাল ব্যাচ এন্ডপয়েন্টকে অবমূল্যায়ন করছে।
- v2 API JSON-RPC প্রোটোকল সমর্থন করে না, যা API v1-এ সমর্থিত ছিল। আবার, এই অবচয় YouTube Analytics API-এর জন্য নির্দিষ্ট নয়।
- API এর সংস্করণ
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
API (v1) এর সংস্করণ 1 এখন বাতিল করা হয়েছে এবং এটি 31 অক্টোবর, 2018 পর্যন্ত সমর্থিত হবে। v1 API-এর সমস্ত অনুরোধ সেই তারিখের পরে কাজ করা বন্ধ করে দেবে। তাই, API-এর মাধ্যমে YouTube অ্যানালিটিক্স ডেটা অ্যাক্সেস করার আপনার ক্ষমতায় কোনো বাধা এড়াতে দয়া করে 31 অক্টোবর, 2018-এর মধ্যে v2 API-তে আপগ্রেড করতে ভুলবেন না।
ফেব্রুয়ারী 21, 2018
এই আপডেটে YouTube অ্যানালিটিক্স (টার্গেটেড কোয়েরি) API-তে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
- ভিউয়ার ডেমোগ্রাফিক রিপোর্ট, যা দর্শকদের বয়স এবং লিঙ্গের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে, এখন আর
youtubeProduct
ডাইমেনশন সমর্থন করে না, যা ইউটিউব পরিষেবাকে চিহ্নিত করে যেখানে ব্যবহারকারীর কার্যকলাপ ঘটেছে৷
18 জানুয়ারী, 2018
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
YouTube রিপোর্টিং API (বাল্ক রিপোর্ট)
-
operating_system
ডাইমেনশন, যা ডিভাইসের সফ্টওয়্যার সিস্টেমকে চিহ্নিত করে যেটিতে দেখা হয়েছে, এখন নিম্নলিখিত মানটিকে সমর্থন করে:-
25
: KaiOS
-
-
YouTube Analytics API (লক্ষ্যযুক্ত প্রশ্ন)
-
operatingSystem
ডাইমেনশনKAIOS
ডাইমেনশন মান সমর্থন করে।
-
ডিসেম্বর 20, 2017
এই আপডেটে YouTube রিপোর্টিং API এর সাথে সম্পর্কিত দুটি পরিবর্তন রয়েছে:
API সার্ভার এখন রিপোর্ট ডাউনলোড করার অনুরোধের জন্য gzip কম্প্রেশন সমর্থন করে। মনে রাখবেন যে জিজিপ কম্প্রেশন অন্যান্য ধরনের API অনুরোধের জন্য সমর্থিত নয়। Gzip কম্প্রেশন সক্ষম করা প্রতিটি API প্রতিক্রিয়ার জন্য প্রয়োজনীয় ব্যান্ডউইথকে হ্রাস করে। এবং, যখন আপনার অ্যাপ্লিকেশনের API প্রতিক্রিয়াগুলিকে কম্প্রেস করতে অতিরিক্ত CPU সময় লাগবে, কম নেটওয়ার্ক সংস্থানগুলি ব্যবহার করার সুবিধা সাধারণত সেই খরচের চেয়ে বেশি।
একটি gzip-এনকোডেড প্রতিক্রিয়া পেতে, নিম্নলিখিত উদাহরণে দেখানো হিসাবে
gzip
এAccept-Encoding
HTTP অনুরোধ শিরোনাম সেট করুন:Accept-Encoding: gzip
এই কার্যকারিতা API ওভারভিউতে এবং
report
রিসোর্সেরdownloadUrl
প্রপার্টির সংজ্ঞায় ব্যাখ্যা করা হয়েছে।এপিআই সেই মাত্রাগুলির জন্য যে প্রকৃত মানগুলি প্রদান করে তা দেখানোর জন্য
age group
এবংgender
মাত্রার ডকুমেন্টেশন সংশোধন করা হয়েছে৷ মনে রাখবেন যে এটি একটি ডকুমেন্টেশন সংশোধন এবং API কার্যকারিতা বা আচরণের পরিবর্তন প্রতিফলিত করে না। বিশেষত, নিম্নলিখিত মানগুলি পরিবর্তিত হয়েছে:-
age_group
মাত্রার মানগুলি বড় হাতের অক্ষর ব্যবহার করে,AGE
শব্দ এবং বয়সের সংখ্যার মধ্যে আন্ডারস্কোর ধারণ করে এবং হাইফেনের পরিবর্তে আন্ডারস্কোর ব্যবহার করে। যেমন,age13-17
এবংage18-24
মতো মানগুলি যথাক্রমেAGE_13_17
এবংAGE_18_24
এ সংশোধন করা হয়েছে৷ -
gender
মাত্রার মানগুলি বড় হাতের অক্ষর ব্যবহার করে। সুতরাং,female
,male
, এবংgender_other
মানগুলিকেFEMALE
,MALE
, এবংGENDER_OTHER
এ সংশোধন করা হয়েছে৷
-
আগস্ট 10, 2017
10 অগাস্ট, 2016-এ, এই ডকুমেন্টেশনটি YouTube Analytics API-এর earnings
মেট্রিকের অবচয় ঘোষণা করেছে। (একই সময়ে, API একটি নতুন মেট্রিকের জন্য সমর্থন যোগ করেছে, নামে estimatedRevenue
, যা একই ডেটা প্রদান করে।)
যেহেতু earnings
মেট্রিক একটি মূল মেট্রিক ছিল, তাই এটি ঘোষণার তারিখ থেকে এক বছরের জন্য সমর্থিত ছিল। এখন সেই বছরব্যাপী সময় শেষ হয়েছে, তবে, earnings
মেট্রিক আর সমর্থিত নয়। ফলস্বরূপ, earnings
মেট্রিক নির্দিষ্ট করে এমন API অনুরোধগুলি এখন একটি 400
HTTP প্রতিক্রিয়া কোড প্রদান করে। আপনি যদি earnings
মেট্রিকের পরিবর্তে estimatedRevenue
মেট্রিক ব্যবহার করার জন্য আপনার অ্যাপটি ইতিমধ্যে আপডেট না করে থাকেন, তাহলে যত তাড়াতাড়ি সম্ভব করুন।
earnings
মেট্রিকের অবশিষ্ট উল্লেখগুলি সরাতে API ডকুমেন্টেশন আপডেট করা হয়েছে।
জুলাই 6, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
YouTube Analytics API (লক্ষ্যযুক্ত প্রশ্ন)
এপিআই ডকুমেন্টেশন আপডেট করা হয়েছে এই সত্যটিকে প্রতিফলিত করার জন্য যে API প্রতিক্রিয়াগুলিতে অনুরোধ করা তারিখের সীমার শেষ দিন পর্যন্ত ডেটা থাকে যার জন্য জিজ্ঞাসা করা সমস্ত মেট্রিক উপলব্ধ।
উদাহরণস্বরূপ, যদি একটি অনুরোধ 5 জুলাই, 2017 এর একটি শেষ তারিখ নির্দিষ্ট করে এবং অনুরোধ করা সমস্ত মেট্রিকের মান শুধুমাত্র 3 জুলাই, 2017 এর মধ্যে উপলব্ধ থাকে, তাহলে সেটিই হবে শেষ তারিখ যার জন্য প্রতিক্রিয়াতে ডেটা অন্তর্ভুক্ত করা হয়েছে৷ (যদিও অনুরোধ করা কিছু মেট্রিক্সের ডেটা 4 জুলাই, 2017-এর জন্য পাওয়া যায় তাহলেও এটি সত্য।)
adType
ডাইমেনশনটি এখনreservedBumperInstream
মানকে সমর্থন করে, যা 6 সেকেন্ড পর্যন্ত একটি অ-ছাড়াযোগ্য ভিডিও বিজ্ঞাপনকে বোঝায় যা একটি ভিডিও দেখার আগে প্লে হয়৷ বিজ্ঞাপনের বিন্যাসটিauctionBumperInstream
বিজ্ঞাপনের অনুরূপ, কিন্তু এই প্রকারটি নিলামের ভিত্তিতে বিক্রি না করে সংরক্ষিত বিজ্ঞাপনগুলিকে বোঝায়।
YouTube রিপোর্টিং API (বাল্ক রিপোর্ট)
ad_type
মাত্রা এখন20
মানকে সমর্থন করে, যা সংরক্ষিত ভিত্তিতে বিক্রি হওয়া বাম্পার বিজ্ঞাপনকে বোঝায়। বাম্পার বিজ্ঞাপনগুলি 6 সেকেন্ড পর্যন্ত অ-ছাড়াযোগ্য ভিডিও বিজ্ঞাপন যা একটি ভিডিও দেখার আগে চালানো হয়। মনে রাখবেন যে এই মাত্রার জন্য মান19
বাম্পার বিজ্ঞাপনগুলিকেও বোঝায় যেগুলি সংরক্ষিত ভিত্তিতে বিক্রি না হয়ে নিলামে বিক্রি হয়৷নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই রিপোর্টগুলির জন্য রিপোর্টিং কাজগুলি মুছে ফেলা হয়েছে:
-
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
এই প্রতিবেদনের প্রকারগুলি 15 সেপ্টেম্বর, 2016 এ অবমূল্যায়ন হিসাবে ঘোষণা করা হয়েছিল এবং 15 ডিসেম্বর, 2016 এর পরে সেই প্রতিবেদনের প্রকারের জন্য প্রতিবেদনগুলি আর উত্পন্ন হয়নি। পূর্বে উত্পন্ন প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে 180 দিনের জন্য এখনও উপলব্ধ ছিল। সুতরাং, কিছু প্রতিবেদন 15 ই জুন, 2017 এর শেষের দিকে অ্যাক্সেসযোগ্য ছিল However তবে, যেহেতু প্রতিবেদনগুলি আর পাওয়া যায় না, তাই প্রতিবেদনের সাথে সম্পর্কিত কাজের প্রয়োজন হয় না।
-
24 মে, 2017
নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই রিপোর্টগুলির জন্য সমস্ত প্রতিবেদনের কাজ মুছে ফেলা হয়েছে:
-
content_owner_ad_performance_a1
-
content_owner_asset_estimated_earnings_a1
-
content_owner_estimated_earnings_a1
এই প্রতিবেদনের প্রকারগুলি 22 জুন, 2016 এ অবমূল্যায়ন হিসাবে ঘোষণা করা হয়েছিল এবং 22 সেপ্টেম্বর, 2016 এর পরে সেই প্রতিবেদনের ধরণের জন্য প্রতিবেদনগুলি আর উত্পন্ন হয়নি। পূর্বে উত্পন্ন প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে 180 দিনের জন্য এখনও উপলব্ধ ছিল। সুতরাং, কিছু প্রতিবেদন 22 মার্চ, 2017 এর শেষের দিকে অ্যাক্সেসযোগ্য ছিল However তবে, যেহেতু প্রতিবেদনগুলি আর পাওয়া যায় না, তাই প্রতিবেদনের সাথে সম্পর্কিত কাজের প্রয়োজন হয় না।
22 মে, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব রিপোর্টিং এপিআই (বাল্ক রিপোর্ট)
-
sharing_service
ডাইমেনশন, যা ভিডিওগুলি ভাগ করতে ব্যবহৃত পরিষেবাটি চিহ্নিত করে, এখন নিম্নলিখিত মানগুলিকে সমর্থন করে:-
85
: ইউটিউব সংগীত -
86
: ইউটিউব গেমিং -
87
: ইউটিউব বাচ্চারা -
88
: ইউটিউব টিভি
তদতিরিক্ত, মান
52
সনাক্ত করতে ব্যবহৃত নামটি কাকাও (কাকাও টক) এর ডকুমেন্টেশনে আপডেট করা হয়েছে এটি আরও স্পষ্টভাবে73
(কাকাও গল্প) থেকে আলাদা করার জন্য। এই পরিবর্তনটি এই পরিষেবাগুলির সাথে ভাগ করা ভিডিওগুলির এপিআই আচরণ বা শ্রেণিবিন্যাসের কোনও পরিবর্তন প্রতিফলিত করে না। -
-
ইউটিউব অ্যানালিটিক্স এপিআই (লক্ষ্যযুক্ত প্রশ্নগুলি)
-
sharingService
ডাইমেনশন এখন নিম্নলিখিত মানগুলিকে সমর্থন করে:-
YOUTUBE_GAMING
-
YOUTUBE_KIDS
-
YOUTUBE_MUSIC
-
YOUTUBE_TV
-
-
28 মার্চ, 2017
চ্যানেল মালিকরা যারা ক্রিয়েটার স্টুডিওতে ইউটিউব অ্যানালিটিক্সের মাধ্যমে উপার্জনের ডেটা অ্যাক্সেস করতে পারেন তারা এখন ইউটিউব অ্যানালিটিক্স এপিআইয়ের মাধ্যমে সেই রাজস্ব ডেটা অ্যাক্সেস করতে পারেন:
এপিআই নিম্নলিখিত উপার্জন সম্পর্কিত মেট্রিকগুলিকে সমর্থন করে:
-
adImpressions
-
cpm
-
estimatedAdRevenue
-
estimatedRedPartnerRevenue
-
estimatedRevenue
-
grossRevenue
-
monetizedPlaybacks
-
playbackBasedCpm
এই মেট্রিকগুলি নিম্নলিখিত প্রতিবেদনের জন্য সমর্থিত:
-
চ্যানেল মালিকরা এখন একটি বিজ্ঞাপন পারফরম্যান্স রিপোর্টও পুনরুদ্ধার করতে পারেন, যা
adType
মাত্রা পাশাপাশি al চ্ছিকday
মাত্রা সমর্থন করে।ইউটিউব অ্যানালিটিক্স এপিআই নমুনা অনুরোধ গাইড এখন চ্যানেল উপার্জন প্রতিবেদনের জন্য একটি বিভাগ অন্তর্ভুক্ত।
17 মার্চ, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব অ্যানালিটিক্স এপিআই
redViews
সমর্থন করে এবংestimatedRedMinutesWatched
মেট্রিকগুলি সমর্থন করে, উভয়ই ইউটিউব রেড ভিউয়ারশিপের সাথে সম্পর্কিত। প্রকৃতপক্ষে, এপিআই আসলে কিছু সময়ের জন্য এই মেট্রিকগুলিকে সমর্থন করেছে এবং ইউটিউব রিপোর্টিং এপিআই ইতিমধ্যে 15 সেপ্টেম্বর, 2016 এ ঘোষিত উভয় মেট্রিককে সমর্থন করে।-
redViews
মেট্রিক ইউটিউব রেড সদস্যদের দ্বারা একটি ভিডিও যে বার দেখা হয়েছিল তার সংখ্যা চিহ্নিত করে। - ইউটিউব রেড সদস্যরা একটি ভিডিও দেখেছেন এমন মিনিটের সংখ্যা চিহ্নিত করে
estimatedRedMinutesWatched
চ্যানেল প্রতিবেদনগুলি এবং সামগ্রীর মালিকের প্রতিবেদনগুলি ডকুমেন্টেশনগুলি আপডেট করা হয়েছে তা দেখানোর জন্য কোন প্রতিবেদন দুটি নতুন মেট্রিককে সমর্থন করে। তারা যে কোনও প্রতিবেদনে ইতিমধ্যে সমর্থন করেছে যা ইতিমধ্যে
views
সমর্থন করে এবংestimatedMinutesWatched
মেট্রিকগুলি সমর্থন করে।-
3 মার্চ, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব রিপোর্টিং এপিআই (বাল্ক রিপোর্ট)
date
মাত্রার সংজ্ঞাটি সংশোধন করা হয়েছে যে মাত্রা মানটি প্যাসিফিক সময় সকাল 12:00 টা থেকে শুরু হওয়া সময়কালকে বোঝায় এবং নির্দিষ্ট দিন, মাস এবং বছরে প্যাসিফিক সময় 11:59 এ শেষ হয়। বছরের সময়ের উপর নির্ভর করে, প্রশান্ত মহাসাগরীয় সময় হয় ইউটিসি -7 বা ইউটিসি -8।যদিও তারিখগুলি সাধারণত 24 ঘন্টা সময়কাল উপস্থাপন করে, যখন ঘড়িগুলি সামনের দিকে সামঞ্জস্য করা হয় তখন তারিখগুলি 23 ঘন্টা সময়কাল উপস্থাপন করে এবং যখন ঘড়িগুলি পিছনে সামঞ্জস্য করা হয় তখন 25 ঘন্টা সময়কাল উপস্থাপন করে। (পূর্বে, ডকুমেন্টেশনটি জানিয়েছিল যে প্রতিটি তারিখ একটি অনন্য 24 ঘন্টা সময়কালের প্রতিনিধিত্ব করে এবং প্রশান্ত মহাসাগরীয় সময় সর্বদা ইউটিসি -8 ছিল)))
নোট করুন যে এই সংশোধনটি প্রকৃত এপিআই আচরণের পরিবর্তনের প্রতিনিধিত্ব করে না।
-
operating_system
ডাইমেনশন, যা ডিভাইসের সফ্টওয়্যার সিস্টেমটি সনাক্ত করে যার উপর দৃষ্টিভঙ্গি ঘটেছে, এখন নিম্নলিখিত মানগুলি সমর্থন করে:-
22
: টিজেন -
23
: ফায়ারফক্স -
24
: রিয়েলমিডিয়া
-
content_owner_basic_a1
রিপোর্ট প্রকারের জন্য সমস্ত রিপোর্টিং কাজ মুছে ফেলা হয়েছে। এই প্রতিবেদনের ধরণটি আগস্ট 19, 2016 পর্যন্ত সম্পূর্ণরূপে অবমূল্যায়ন করা হয়েছিল, তবে পূর্বে উত্পন্নcontent_owner_basic_a1
প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে 180 দিনের জন্য এখনও উপলব্ধ ছিল। সুতরাং, কিছু প্রতিবেদন 19 ফেব্রুয়ারী, 2017 এর শেষের দিকে অ্যাক্সেসযোগ্য ছিল However তবে, যেহেতু প্রতিবেদনগুলি আর পাওয়া যায় না, তাই প্রতিবেদনের সাথে সম্পর্কিত কাজের প্রয়োজন হয় না।
ইউটিউব অ্যানালিটিক্স এপিআই (লক্ষ্যযুক্ত প্রশ্নগুলি)
time periods
সাথে সম্পর্কিত মাত্রাগুলির বিবরণটি সংশোধন করা হয়েছে যে মাত্রা মানটি প্যাসিফিক সময় সকাল 12:00 টা থেকে শুরু হওয়া সময়কালকে বোঝায় এবং নির্দিষ্ট দিন, মাস এবং বছরে প্যাসিফিক সময় 11:59 এ শেষ হয়। বছরের সময়ের উপর নির্ভর করে, প্রশান্ত মহাসাগরীয় সময় হয় ইউটিসি -7 বা ইউটিসি -8।যদিও তারিখগুলি সাধারণত 24 ঘন্টা সময়কাল উপস্থাপন করে, যখন ঘড়িগুলি সামনের দিকে সামঞ্জস্য করা হয় তখন তারিখগুলি 23 ঘন্টা সময়কাল উপস্থাপন করে এবং যখন ঘড়িগুলি পিছনে সামঞ্জস্য করা হয় তখন 25 ঘন্টা সময়কাল উপস্থাপন করে। (পূর্বে, ডকুমেন্টেশনটি জানিয়েছিল যে প্যাসিফিক সময়টি ইউটিসি -8 ছিল এবং এই সম্ভাবনাটি উল্লেখ করেনি যে কোনও দিন 24 ঘন্টা সময়কালের প্রতিনিধিত্ব করতে পারে না))
নোট করুন যে এই সংশোধনটি প্রকৃত এপিআই আচরণের পরিবর্তনের প্রতিনিধিত্ব করে না।
চ্যানেল প্রতিবেদনগুলি ডকুমেন্টেশনটি নোট করার জন্য আপডেট করা হয়েছে যে চ্যানেল প্রতিবেদনে বর্তমানে উপার্জন বা বিজ্ঞাপন পারফরম্যান্স মেট্রিকগুলি নেই। ফলস্বরূপ,
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
স্কোপ বর্তমানে চ্যানেল রিপোর্টগুলিতে আর্থিক ডেটাতে অ্যাক্সেস দেয় না।-
operatingSystem
মাত্রা তিনটি নতুন মাত্রার মান সমর্থন করে:-
FIREFOX
-
REALMEDIA
-
TIZEN
-
ফেব্রুয়ারী 8, 2017
ইউটিউব অ্যানালিটিক্স এপিআই এখন al চ্ছিক include-historical-channel-data
প্যারামিটার সমর্থন করে। নোট করুন যে সামগ্রীর মালিকের প্রতিবেদনগুলি পুনরুদ্ধার করার সময় এই প্যারামিটারটি কেবল প্রাসঙ্গিক।
প্যারামিটারটি কোনও সামগ্রীর মালিককে নির্দেশ করতে দেয় যে একটি এপিআই প্রতিক্রিয়াতে চ্যানেলগুলির ঘড়ির সময় এবং চ্যানেলগুলি সামগ্রীর মালিকের সাথে লিঙ্কযুক্ত হওয়ার আগে সময়কাল থেকে ডেটা দেখার অন্তর্ভুক্ত করা উচিত। ডিফল্ট প্যারামিটারের মানটি false
, যার অর্থ হ'ল ডিফল্টরূপে, এপিআই প্রতিক্রিয়াটিতে কেবল ঘড়ির সময় এবং ডেটা দেখুন যে সময় থেকে চ্যানেলগুলি সামগ্রীর মালিকের সাথে সংযুক্ত ছিল।
এই বিধিগুলিও প্রযোজ্য যদি এপিআই অনুরোধটি একাধিক চ্যানেলের জন্য ডেটা পুনরুদ্ধার করে:
- যদি প্যারামিটারের মানটি
false
হয়, তবে প্রদত্ত যে কোনও চ্যানেলের জন্য ফিরে আসা ঘড়ির সময় এবং ভিউ ডেটাগুলি সেই চ্যানেলটি সামগ্রীর মালিকের সাথে যুক্ত হওয়ার তারিখের উপর ভিত্তি করে।
এটি মনে রাখা গুরুত্বপূর্ণ যে বিভিন্ন চ্যানেলগুলি বিভিন্ন তারিখে কোনও সামগ্রীর মালিকের সাথে যুক্ত থাকতে পারে। যদি এপিআই অনুরোধটি একাধিক চ্যানেলের জন্য ডেটা পুনরুদ্ধার করে এবং প্যারামিটারের মানটিfalse
হয়, তবে এপিআই প্রতিক্রিয়াতে প্রতিটি চ্যানেলের সংযোগের তারিখের ভিত্তিতে ঘড়ির সময় এবং ডেটা দেখুন। - যদি প্যারামিটারের মানটি
true
হয়, তবে প্রতিক্রিয়াটি এপিআই অনুরোধে উল্লিখিত শুরু এবং শেষের তারিখের ভিত্তিতে সমস্ত চ্যানেলের জন্য সময় এবং ডেটা দেখার সময় এবং দেখুন।
ডিসেম্বর 15, 2016
নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই রিপোর্টগুলি আর সমর্থিত নয় এবং ডকুমেন্টেশন থেকে সরানো হয়েছে। প্রতিটি প্রতিবেদনের একটি নতুন সংস্করণ উপলব্ধ। (এই প্রতিবেদনের জন্য অবমূল্যায়নের ঘোষণা 15 সেপ্টেম্বর, 2016 এ করা হয়েছিল))
চ্যানেল রিপোর্ট
-
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
2 রিপোর্ট দ্বারা প্রতিস্থাপন করা হয়েছে। -
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
প্রতিবেদন দ্বারা প্রতিস্থাপিত।
-
এপিআই রেফারেন্স ডকুমেন্টেশনে বর্তমান প্রতিবেদনের ধরণের তালিকাগুলিও আপডেট করা হয়েছে।
11 নভেম্বর, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
শেষ স্ক্রিন রিপোর্ট
- চ্যানেল ভিডিওগুলির জন্য শেষ স্ক্রিন প্রতিবেদনে একটি চ্যানেলের সমস্ত ভিডিওর পরিসংখ্যান রয়েছে।
- সামগ্রী মালিকের ভিডিওগুলির জন্য শেষ স্ক্রিন প্রতিবেদনে কোনও সামগ্রীর মালিকের চ্যানেলে ভিডিওগুলির জন্য পরিসংখ্যান রয়েছে।
- সামগ্রীর মালিক সম্পদের জন্য শেষ স্ক্রিন প্রতিবেদনে ভিডিওগুলির সাথে সম্পর্কিত সম্পদের জন্য পরিসংখ্যান রয়েছে যার পরে শেষ স্ক্রিনগুলি প্রদর্শিত হয়।
শেষ স্ক্রিনের মাত্রা
-
end_screen_element_type
: পরিসংখ্যানের সাথে যুক্ত শেষ স্ক্রিন উপাদানগুলির ধরণ। -
end_screen_element_id
: ইউটিউব শেষ স্ক্রিন উপাদানটি অনন্যভাবে সনাক্ত করতে যে আইডি ব্যবহার করে।
-
শেষ স্ক্রিন মেট্রিক
দ্রষ্টব্য: শেষ স্ক্রিন মেট্রিকের ডেটা 1 মে, 2016 পর্যন্ত উপলব্ধ।
-
end_screen_element_impressions
: শেষ স্ক্রিন উপাদান ইমপ্রেশনগুলির মোট সংখ্যা। একটি ছাপ প্রদর্শিত প্রতিটি শেষ স্ক্রিন উপাদান জন্য লগ করা হয়। -
end_screen_element_clicks
: শেষ স্ক্রিনের উপাদানগুলিতে কতবার ক্লিক করা হয়েছিল। -
end_screen_element_click_rate
: শেষ স্ক্রিন উপাদানগুলির জন্য ক্লিক-মাধ্যমে হার।
-
নিম্নলিখিত প্রতিবেদনগুলি আর সমর্থিত নয় এবং ডকুমেন্টেশন থেকে সরানো হয়েছে। প্রতিটি প্রতিবেদনের একটি নতুন সংস্করণ উপলব্ধ। (এই প্রতিবেদনের জন্য অবমূল্যায়নের ঘোষণাটি 22 জুন, 2016 এ করা হয়েছিল।)
-
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
1 প্রতিবেদন দ্বারা প্রতিস্থাপন করা হয়েছে।
-
নিম্নলিখিত তালিকার মেট্রিকগুলি সম্পূর্ণরূপে অবমূল্যায়িত এবং আর সমর্থিত নয়। 10 আগস্ট, 2016 এ ঘোষিত হিসাবে, একই ডেটা উল্লেখ করে নতুন মেট্রিকগুলি ইতিমধ্যে সমর্থিত। নীচের টেবিলটি অবনমিত মেট্রিক নাম এবং নতুন মেট্রিক নাম দেখায়:
অবমূল্যায়িত মেট্রিক নতুন মেট্রিক adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- মাসিক, ভিডিও প্রতি বিশ্বব্যাপী বিজ্ঞাপন উপার্জন
- প্রতিদিন, প্রতি-দেশে বিজ্ঞাপনের প্রতি রাজস্ব প্রতি
- মাসিক, সম্পদ প্রতি বিশ্বব্যাপী বিজ্ঞাপন উপার্জন
- দৈনিক, প্রতি দেশে বিজ্ঞাপনের প্রতি আয়
- দাবি (এই প্রতিবেদনে রাজস্বের ডেটা নেই)
এপিআই ইউটিউব রেড ভিউয়ারশিপ সম্পর্কিত দুটি নতুন মেট্রিক সমর্থন করে:
-
red_views
: ইউটিউব রেড সদস্যরা যে ভিডিওটি দেখেছিলেন তার সংখ্যা। -
red_watch_time_minutes
: ইউটিউব রেড সদস্যরা একটি ভিডিও দেখেছেন এমন মিনিটের সংখ্যা।
-
এপিআই 20 টি প্রতিবেদনের নতুন সংস্করণ সমর্থন করে। সমস্ত নতুন সংস্করণ নতুন
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
আপনার যদি এই প্রতিবেদনের যে কোনওটির জন্য চাকরি থাকে তবে আপনার আশা করা উচিত নয় যে ইউটিউব 15 ডিসেম্বর, 2016 এর পরে সেই চাকরির জন্য নতুন প্রতিবেদন তৈরি করবে। উত্পন্ন প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে এখনও 180 দিনের জন্য উপলব্ধ থাকবে।
-
content_owner_basic_a1
প্রতিবেদনটি সম্পূর্ণরূপে অবমূল্যায়ন করা হয়েছে এবং ডকুমেন্টেশন থেকে সরানো হয়েছে। ইউটিউব আর এই ধরণের নতুন প্রতিবেদন তৈরি করবে না, যদিও ইতিমধ্যে উত্পন্ন প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে 180 দিনের জন্য উপলব্ধ থাকবে।content_owner_basic_a1
রিপোর্টের প্রতিস্থাপনটি হ'ল 19 ই মে, 2016 এর পুনর্বিবেচনার ইতিহাস এন্ট্রি -তে বর্ণিতcontent_owner_basic_a2
প্রতিবেদন।ইউটিউব ইঞ্জিনিয়ারিং এবং বিকাশকারী ব্লগে বিস্তারিত আলোচনা করা নতুন প্রকাশিত ইউটিউব এপিআই পরিষেবাদির শর্তাদি ("আপডেটেড শর্তাদি"), বর্তমান পরিষেবার শর্তাদি আপডেটগুলির একটি সমৃদ্ধ সেট সরবরাহ করে। আপডেট হওয়া শর্তাদি ছাড়াও, যা ফেব্রুয়ারী 10, 2017 পর্যন্ত কার্যকর হবে, এই আপডেটে বিকাশকারীদের অবশ্যই অনুসরণ করতে হবে এমন নীতিগুলি ব্যাখ্যা করতে সহায়তা করার জন্য বেশ কয়েকটি সহায়ক নথি অন্তর্ভুক্ত রয়েছে।
নতুন নথিগুলির সম্পূর্ণ সেটটি আপডেট হওয়া শর্তগুলির জন্য সংশোধন ইতিহাসে বর্ণিত হয়েছে। তদতিরিক্ত, আপডেট হওয়া শর্তাদি বা সেই সমর্থনকারী নথিগুলিতে ভবিষ্যতের পরিবর্তনগুলিও সেই সংশোধন ইতিহাসে ব্যাখ্যা করা হবে। আপনি সেই ডকুমেন্টের একটি লিঙ্ক থেকে সেই সংশোধন ইতিহাসের কোনও আরএসএস ফিড তালিকা পরিবর্তনগুলিতে সাবস্ক্রাইব করতে পারেন।
ইউটিউব অ্যানালিটিক্স এপিআই (লক্ষ্যযুক্ত প্রশ্নগুলি)
দ্রষ্টব্য: এটি একটি অবমূল্যায়নের ঘোষণা।
নিম্নলিখিত টেবিলের মেট্রিকগুলি হ্রাস করা হচ্ছে। একই সময়ে, একই ডেটা উল্লেখ করে নতুন মেট্রিকগুলি চালু করা হচ্ছে। বাস্তবে, এর অর্থ এই যে পুরানো মেট্রিকগুলির নামকরণ করা হচ্ছে, যদিও ইউটিউব অ্যানালিটিক্স এপিআই টেবিলের মধ্যে তালিকাভুক্ত অবমূল্যায়নের তারিখ না হওয়া পর্যন্ত উভয় মেট্রিক নাম সমর্থন করবে।
পুরানো মেট্রিক নাম নতুন মেট্রিক নাম সমর্থন তারিখ earnings
estimatedRevenue
আগস্ট 10, 2017 adEarnings
estimatedAdRevenue
নভেম্বর 4, 2016 redPartnerRevenue
estimatedRedPartnerRevenue
নভেম্বর 4, 2016 impressionBasedCpm
cpm
নভেম্বর 4, 2016 impressions
adImpressions
নভেম্বর 4, 2016 নোট করুন যে
earnings
মেট্রিক একটি মূল মেট্রিক ছিল, সুতরাং এটি এই ঘোষণার তারিখ থেকে এক বছরের জন্য সমর্থিত হবে। অন্যান্য মেট্রিকগুলি, যা মূল মেট্রিক ছিল না, 4 নভেম্বর, 2016 অবধি তিন মাসের জন্য সমর্থিত হবে।উদাহরণস্বরূপ, 4 নভেম্বর, 2016 অবধি, একটি এপিআই অনুরোধটি
impressionBasedCpm
মেট্রিক,cpm
মেট্রিক বা উভয়ই নির্দিষ্ট করতে পারে। যাইহোক, সেই তারিখের পরে, কেবলcpm
মেট্রিক সমর্থিত হবে।-
insightTrafficSourceType
টাইপ ডাইমেনশন দুটি নতুন মাত্রা মান সমর্থন করে:-
CAMPAIGN_CARD
: এই ট্র্যাফিক উত্সটি কেবল সামগ্রীর মালিকের প্রতিবেদনের জন্য সমর্থিত। এটি ইঙ্গিত দেয় যে মতামতগুলি দাবি করা, ব্যবহারকারী-আপলোড করা ভিডিওগুলি থেকে উদ্ভূত হয়েছিল যা সামগ্রীর মালিক দেখার বিষয়বস্তু প্রচারের জন্য ব্যবহার করেছিলেন। -
END_SCREEN
: ডেটা অন্য ভিডিওর এন্ডস্ক্রিন থেকে উদ্ভূত দর্শনগুলির সাথে সম্পর্কিত।
উভয় নতুন ট্র্যাফিক উত্সের জন্য, আপনি
traffic source detail
প্রতিবেদনটিও পুনরুদ্ধার করতে পারেন। উভয় ক্ষেত্রেই,insightTrafficSourceDetail
মাত্রা ভিডিওটি সনাক্ত করে যা থেকে দর্শকের উল্লেখ করা হয়েছিল। -
adType
মাত্রা এখনauctionBumperInstream
মানকে সমর্থন করে, যা কোনও ভিডিও দেখার আগে নাটকগুলি 6 সেকেন্ড পর্যন্ত অ-স্কিপেবল ভিডিও বিজ্ঞাপনকে বোঝায়।
ইউটিউব রিপোর্টিং এপিআই (বাল্ক রিপোর্ট)
-
traffic_source_type
টাইপের মাত্রা এখন নিম্নলিখিত মানগুলিকে সমর্থন করে:-
19
: এই ট্র্যাফিক উত্সটি কেবল সামগ্রীর মালিকের প্রতিবেদনের জন্য সমর্থিত। এটি ইঙ্গিত দেয় যে মতামতগুলি দাবি করা, ব্যবহারকারী-আপলোড করা ভিডিওগুলি থেকে উদ্ভূত হয়েছিল যা সামগ্রীর মালিক দেখার বিষয়বস্তু প্রচারের জন্য ব্যবহার করেছিলেন। -
20
: ডেটা অন্য ভিডিওর এন্ডস্ক্রিন থেকে উদ্ভূত দর্শনগুলির সাথে সম্পর্কিত।
উভয় নতুন ট্র্যাফিক উত্সের জন্য,
traffic_source_detail
মাত্রা ভিডিওটি সনাক্ত করে যা থেকে দর্শকের উল্লেখ করা হয়েছিল। -
কোর মেট্রিকগুলির এপিআইয়ের তালিকাটি কোর মেট্রিক হিসাবে
estimated_partner_revenue
তালিকাভুক্ত করতে এবং সেই তালিকা থেকেearnings
সরিয়ে দেওয়ার জন্য সংশোধন করা হয়েছে। (ইউটিউব রিপোর্টিং এপিআই -তেearnings
মেট্রিককে কখনও সমর্থন করা হয়নি))ad_type
মাত্রা এখন19
মানকে সমর্থন করে যা বাম্পার বিজ্ঞাপনগুলিকে বোঝায়, যা কোনও ভিডিও দেখার আগে খেলতে পারে এমন 6 সেকেন্ড পর্যন্ত অ-স্কিপেবল ভিডিও বিজ্ঞাপন।
-
ইউটিউব অ্যানালিটিক্স এপিআই (লক্ষ্যযুক্ত প্রশ্নগুলি)
- নিম্নলিখিত চ্যানেল প্রতিবেদনের জন্য সমর্থিত মেট্রিকগুলির তালিকাগুলি কার্ড মেট্রিকগুলি অন্তর্ভুক্ত করার জন্য আপডেট করা হয়েছে। এই প্রতিবেদনে কার্ড মেট্রিকগুলির জন্য সমর্থনটি আসলে 28 জুন, 2016 এ যুক্ত করা হয়েছিল এবং সেই তারিখের জন্য পুনর্বিবেচনার ইতিহাস এন্ট্রি আরও বিশদে পরিবর্তনের ব্যাখ্যা দেয়। প্রতিবেদনগুলো হল:
- মার্কিন যুক্তরাষ্ট্রের জন্য বেসিক ব্যবহারকারী ক্রিয়াকলাপ
- মার্কিন যুক্তরাষ্ট্রে ব্যবহারকারীর ক্রিয়াকলাপ নির্দিষ্ট সময়কালের জন্য রাজ্যগুলি
- প্রদেশ দ্বারা ব্যবহারকারীর ক্রিয়াকলাপ
- সাবস্ক্রাইব স্ট্যাটাস দ্বারা ব্যবহারকারীর ক্রিয়াকলাপ
- প্রদেশগুলির জন্য সাবস্ক্রাইব স্ট্যাটাস দ্বারা ব্যবহারকারীর ক্রিয়াকলাপ
- রাষ্ট্র দ্বারা শীর্ষ ভিডিও
- সাবস্ক্রাইবড বা সাবস্ক্রাইবড দর্শকদের জন্য শীর্ষ ভিডিও
ফিল্টারগুলির তালিকাগুলি উভয় চ্যানেল শ্রোতা ধরে রাখার প্রতিবেদন এবং সামগ্রীর মালিক শ্রোতাদের ধরে রাখার প্রতিবেদনগুলির জন্য সংশোধন করা হয়েছে যে
video
ফিল্টারটি প্রয়োজনীয় এবংgroup
ফিল্টারটি সমর্থিত নয় তা প্রতিফলিত করতে।পূর্বে, উভয় প্রতিবেদনের ডকুমেন্টেশন ভুলভাবে জানিয়েছিল যে এই দুটি ফিল্টারগুলির মধ্যে একটি ব্যবহার করে বা ফিল্টার না ব্যবহার করে প্রতিবেদনটি পুনরুদ্ধার করা যেতে পারে।
- নিম্নলিখিত চ্যানেল প্রতিবেদনের জন্য সমর্থিত মেট্রিকগুলির তালিকাগুলি কার্ড মেট্রিকগুলি অন্তর্ভুক্ত করার জন্য আপডেট করা হয়েছে। এই প্রতিবেদনে কার্ড মেট্রিকগুলির জন্য সমর্থনটি আসলে 28 জুন, 2016 এ যুক্ত করা হয়েছিল এবং সেই তারিখের জন্য পুনর্বিবেচনার ইতিহাস এন্ট্রি আরও বিশদে পরিবর্তনের ব্যাখ্যা দেয়। প্রতিবেদনগুলো হল:
ইউটিউব রিপোর্টিং এপিআই (বাল্ক রিপোর্ট)
- এপিআই ওভারভিউতে , যে বিভাগটি কোনও প্রতিবেদনের ডাউনলোড ইউআরএল পুনরুদ্ধার করবেন তা ব্যাখ্যা করে এমন বিভাগটি সংশোধন করা হয়েছে যে ইউটিউব এমন দিনগুলিতে ডাউনলোডযোগ্য প্রতিবেদন তৈরি করে যেখানে কোনও ডেটা উপলব্ধ ছিল না। এই প্রতিবেদনে একটি শিরোনাম সারি রয়েছে তবে অতিরিক্ত ডেটা নেই। এই তথ্যটি ইতিমধ্যে 12 এপ্রিল, 2016 এ একই নথির প্রতিবেদন বৈশিষ্ট্য বিভাগে আপডেট করা হয়েছিল।
-
content_owner_asset_cards_a1
প্রতিবেদনে মাত্রার তালিকাটি সংশোধন করা হয়েছে যে প্রতিবেদনটিcard_id
মাত্রা ব্যবহার করে। পূর্বে, ডকুমেন্টেশনটি ভুলভাবে ডিআইএমএনএটি নামটিcard_title
হিসাবে তালিকাভুক্ত করেছিল।
- বেসিক পরিসংখ্যান ( চ্যানেল , সামগ্রী মালিক )
- সময় ভিত্তিক ( চ্যানেল , সামগ্রী মালিক )
- ব্যবহারকারী ভূগোল ( চ্যানেল , সামগ্রী মালিক )
- সাবস্ক্রাইব স্ট্যাটাস ( চ্যানেল , সামগ্রী মালিক ) দ্বারা ব্যবহারকারীর ক্রিয়াকলাপ
- শীর্ষ ভিডিও ( চ্যানেল , সামগ্রী মালিক )
এপিআই ওভারভিউয়ের প্রতিবেদন বৈশিষ্ট্য বিভাগটি স্পষ্ট করে আপডেট করা হয়েছে যে তারা উত্পন্ন হওয়ার সময় থেকে 180 দিনের জন্য এপিআইয়ের মাধ্যমে প্রতিবেদনগুলি উপলব্ধ।
পূর্বে, ডকুমেন্টেশনটি জানিয়েছিল যে এপিআইয়ের অনুরোধটি প্রেরণের তারিখের 180 দিন পর্যন্ত প্রতিবেদনগুলি উপলব্ধ। প্রযুক্তিগতভাবে সত্য হলেও, মূল পাঠ্যটি ছিল সর্বোপরি, বরং বিভ্রান্তিকর।
এপিআই তিনটি প্রতিবেদনের নতুন সংস্করণ সমর্থন করে। এই প্রতিবেদনের মধ্যে দুটিতে নতুন এবং নামকরণ করা মেট্রিক রয়েছে:
content_owner_ad_rates_a1
প্রতিবেদনটিcontent_owner_ad_performance_a1
প্রতিবেদনের নতুন সংস্করণ। নতুন নামকরণ করা প্রতিবেদনটি পূর্ববর্তী সংস্করণটির মতো।নতুন সংস্করণ রয়েছে এমন দুটি প্রতিবেদন নামকরণ করা হয়েছে:
-
content_owner_estimated_earnings_a1
1 রিপোর্টের নতুন সংস্করণটির নাম দেওয়া হয়েছেcontent_owner_estimated_revenue_a1
। -
content_owner_asset_estimated_earnings_a1
1 রিপোর্টের নতুন সংস্করণটির নাম দেওয়া হয়েছেcontent_owner_asset_estimated_revenue_a1
।
উভয় নতুন নামকরণ প্রতিবেদন নিম্নলিখিত উপায়ে তাদের পূর্বসূরীদের থেকে পৃথক:
- তারা নতুন
estimated_partner_red_revenue
মেট্রিক যুক্ত করে, যা ইউটিউব লাল সাবস্ক্রিপশন থেকে মোট উপার্জনের অনুমান করে। - তারা নতুন
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
1,content_owner_estimated_earnings_a1
, এবংcontent_owner_asset_estimated_earnings_a1
প্রতিবেদনগুলি হ্রাস করা হয়েছে।আপনার যদি এই প্রতিবেদনের কোনওটির জন্য চাকরি থাকে তবে আপনার আশা করা উচিত নয় যে ইউটিউব 22 সেপ্টেম্বর, 2016 এর পরে সেই চাকরির জন্য নতুন প্রতিবেদন তৈরি করবে। উত্পন্ন প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে 180 দিনের জন্য এখনও উপলব্ধ থাকবে।
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
।
-
রিপোর্টিং এপিআইয়ের জন্য ডাইমেনশন ডকুমেন্টেশনগুলি আর
elapsed_video_time_percentage
এবংaudience_retention_type
বৈশিষ্ট্যগুলি তালিকাভুক্ত করার জন্য আপডেট করা হয়েছে। এই মাত্রাগুলি বর্তমানে এপিআইয়ের মাধ্যমে উপলব্ধ কোনও প্রতিবেদন দ্বারা সমর্থিত নয়।এপিআই সামগ্রী মালিকদের জন্য ব্যবহারকারী ক্রিয়াকলাপ প্রতিবেদনের একটি নতুন সংস্করণ সমর্থন করে। নতুন প্রতিবেদনের জন্য প্রতিবেদন টাইপ আইডি হ'ল
content_owner_basic_a2
। প্রতিবেদনের পূর্ববর্তী সংস্করণটির বিপরীতে,content_owner_basic_a1
, নতুন সংস্করণটি মেট্রিকগুলিlikes
এবংdislikes
সমর্থন করে।আপনার যদি ইতিমধ্যে
content_owner_basic_a1
প্রতিবেদন তৈরি করার জন্য একটি কাজ থাকে তবে আপনাকে এখনওcontent_owner_basic_a2
প্রতিবেদনের জন্য একটি নতুন কাজ তৈরি করতে হবে। ইউটিউব স্বয়ংক্রিয়ভাবে সামগ্রী মালিকদের নতুন প্রতিবেদন সংস্করণে স্থানান্তরিত করছে না বা নতুন প্রতিবেদন সংস্করণ তৈরি করতে স্বয়ংক্রিয়ভাবে একটি কাজ তৈরি করছে না। কিছু বাস্তবায়নে, একটি নতুন, অপ্রত্যাশিত কাজের উপস্থিতি একটি ব্রেকিং পরিবর্তন হতে পারে।নতুন প্রতিবেদন প্রকাশের সাথে একত্রে,
content_owner_basic_a1
প্রতিবেদনটি হ্রাস করা হয়েছে। আপনার যদি এই প্রতিবেদনের জন্য কোনও কাজ থাকে তবে আপনার আশা করা উচিত নয় যে ইউটিউব 19 আগস্ট, 2016 এর পরে সেই কাজের জন্য নতুন প্রতিবেদন তৈরি করবে। উত্পন্ন প্রতিবেদনগুলি উত্পন্ন হওয়ার সময় থেকে এখনও 180 দিনের জন্য উপলব্ধ থাকবে।reportType
,job
এবংreport
সংস্থানগুলি সমস্ত একটি নতুন সম্পত্তি সমর্থন করে যা সম্পর্কিত সংস্থানটি কোনও অবমূল্যায়িত প্রতিবেদনের প্রকারের প্রতিনিধিত্ব করে কিনা তা চিহ্নিত করে:reportType
রিসোর্সেরdeprecateTime
সম্পত্তি প্রতিবেদনের ধরণটি হ্রাস করা হবে এমন তারিখ এবং সময় নির্দিষ্ট করে। এই সম্পত্তি কেবলমাত্র প্রতিবেদনের জন্য একটি মান রয়েছে যা অবমূল্যায়িত হিসাবে ঘোষণা করা হয়েছে এবং মানটি সেই তারিখের প্রতিনিধিত্ব করে যখন ইউটিউব সেই ধরণের প্রতিবেদন তৈরি করা বন্ধ করবে।কোনও প্রতিবেদনের ধরণকে অবমূল্যায়ন হিসাবে ঘোষণা করার পরে, ইউটিউব আরও তিন মাস ধরে এই ধরণের প্রতিবেদন তৈরি করে। উদাহরণস্বরূপ, 19 ই মে, 2016 এ এই আপডেটটি
content_owner_basic_a1
রিপোর্টের অবমূল্যায়নের ঘোষণা দিয়েছে। সুতরাং, সেই প্রতিবেদনের প্রকারেরdeprecateTime
19 আগস্ট, 2016 এ একটি সময় নির্দিষ্ট করে, এর পরে ইউটিউব সেই ধরণের প্রতিবেদন তৈরি করা বন্ধ করবে।job
রিসোর্সেরexpireTime
সম্পত্তিটি চাকরির মেয়াদ শেষ হয়ে গেছে বা মেয়াদ শেষ হবে তার তারিখ এবং সময় নির্দিষ্ট করে। কাজের সাথে সম্পর্কিত প্রতিবেদনের ধরণটি যদি হ্রাস করা হয় বা কাজের জন্য উত্পন্ন প্রতিবেদনগুলি দীর্ঘ সময়ের জন্য ডাউনলোড না করা হয় তবে এই সম্পত্তিটির একটি মূল্য রয়েছে। তারিখটি সেই সময়টিকে চিহ্নিত করে যার পরে ইউটিউব আর কাজের জন্য নতুন প্রতিবেদন তৈরি করে না।report
রিসোর্সেরjobExpireTime
সম্পত্তি প্রতিবেদনের সাথে সম্পর্কিত যে কাজটি শেষ হয়ে গেছে বা মেয়াদ শেষ হয়ে যাবে তার তারিখ এবং সময় নির্দিষ্ট করে। এই সম্পত্তিটি এই তালিকার পূর্ববর্তী আইটেমটিতে বর্ণিত হিসাবেjob
সংস্থানটিতেexpireTime
সম্পত্তির মতো একই মান রয়েছে।
jobs.create
400
Bad Request
তদতিরিক্ত, পদ্ধতির ডকুমেন্টেশনগুলি এখন আরও কয়েকটি কারণের তালিকাভুক্ত করে যা একটি এপিআই অনুরোধ ব্যর্থ হওয়ার কারণ করে।ইউটিউব এখন রিপোর্টিংয়ের কাজটি প্রথমে নির্ধারিত হওয়ার আগে 180 দিনের সময়কালের কভার করে ডেটা উত্পন্ন করে। পূর্বে, রিপোর্টিং এপিআই কোনও historical তিহাসিক ডেটা সরবরাহ করে নি। এই পরিবর্তনটি এই ঘোষণার পূর্বে তৈরি হওয়া সমস্ত কাজকে প্রভাবিত করে।
They তিহাসিক প্রতিবেদনগুলি উপলভ্য হওয়ার সাথে সাথেই পোস্ট করা হয়, যদিও এটি কোনও কাজের জন্য পোস্ট করতে সমস্ত historical তিহাসিক ডেটা প্রায় এক মাস সময় নেয়। সুতরাং, প্রতিবেদনের কাজের সময় নির্ধারণের এক মাস পরে, আপনার প্রায় সাত মাসের ডেটা অ্যাক্সেস থাকবে। (এই ঘোষণার আগে তৈরি কাজের জন্য সমস্ত historical তিহাসিক তথ্য ঘোষণার এক মাসের মধ্যে পোস্ট করা উচিত))
নোট করুন যে historical তিহাসিক ডেটা কেবল জুলাই 1, 2015 পর্যন্ত উপলভ্য। ফলস্বরূপ, 28 ডিসেম্বর, 2015 এর আগে তৈরি করা কাজগুলিতে 180 দিনেরও কম historical তিহাসিক ডেটা থাকবে।
এই পরিবর্তনগুলি সমস্ত রিপোর্টিং এপিআই ওভারভিউয়ের নতুন historical তিহাসিক ডেটা বিভাগে ব্যাখ্যা করা হয়েছে।
ইউটিউব রিপোর্টিং এপিআই ওভারভিউয়ের প্রতিবেদন বৈশিষ্ট্য বিভাগটি নিম্নলিখিত পরিবর্তনগুলির সাথে আপডেট করা হয়েছে:
ডকুমেন্টেশনে এখন বলা হয়েছে যে প্রতিবেদনগুলি উত্পন্ন হওয়ার পরে 180 দিনের জন্য উপলব্ধ এবং তাই এপিআই ক্লায়েন্টদের ডাউনলোড করার জন্য উপলব্ধ। পূর্বে, ডকুমেন্টেশনটি জানিয়েছিল যে এপিআইয়ের অনুরোধটি প্রেরণের তারিখের আগে ছয় মাস পর্যন্ত প্রতিবেদনগুলি উপলব্ধ ছিল।
ডকুমেন্টেশনটি এপিআই এখন এমন কয়েক দিনের জন্য ডাউনলোডযোগ্য প্রতিবেদন তৈরি করে এমনটি প্রতিফলিত করার জন্য আপডেট করা হয়েছে যেখানে কোনও ডেটা উপলব্ধ ছিল না। এই প্রতিবেদনে শিরোনাম সারি থাকবে তবে অতিরিক্ত ডেটা থাকবে না।
ইউটিউব রিপোর্টিং এপিআই শীঘ্রই স্বয়ংক্রিয়ভাবে উত্পাদিত, সিস্টেম-পরিচালিত প্রতিবেদনের একটি সেটকে সমর্থন করবে যাতে বিজ্ঞাপনের উপার্জন ডেটা বা ইউটিউব রেড সাবস্ক্রিপশন উপার্জনের ডেটা রয়েছে। প্রতিবেদনগুলি এমন সামগ্রী মালিকদের জন্য উপলব্ধ হবে যারা ইতিমধ্যে ইউটিউব স্রষ্টা স্টুডিওতে ম্যানুয়ালি ডাউনলোডযোগ্য উপার্জন প্রতিবেদনগুলি অ্যাক্সেস করতে পারে। সুতরাং, নতুন এপিআই কার্যকারিতা সেই ডেটাতে প্রোগ্রাম্যাটিক অ্যাক্সেস সরবরাহ করবে।
সিস্টেম-পরিচালিত প্রতিবেদনগুলি চালু করার প্রস্তুতিতে এখন নিম্নলিখিত এপিআই পরিবর্তনগুলি ঘোষণা করা হচ্ছে:
job
রিসোর্সের নতুনsystemManaged
সম্পত্তিটি ইঙ্গিত দেয় যে সংস্থানটি এমন কোনও কাজের বর্ণনা দেয় যা সিস্টেম-পরিচালিত প্রতিবেদন তৈরি করে। ইউটিউব স্বয়ংক্রিয়ভাবে ইউটিউব সামগ্রীর মালিকদের জন্য সিস্টেম-পরিচালিত প্রতিবেদন তৈরি করে এবং সামগ্রী মালিকরা সেই প্রতিবেদনগুলি তৈরি করে এমন কাজগুলি সংশোধন বা মুছতে পারে না।jobs.list
পদ্ধতির নতুনincludeSystemManaged
প্যারামিটারটি নির্দেশ করে যে এপিআই প্রতিক্রিয়াটিতে সিস্টেম-পরিচালিত প্রতিবেদনের জন্য চাকরি অন্তর্ভুক্ত করা উচিত কিনা। প্যারামিটারের ডিফল্ট মানটিfalse
।jobs.reports.list
startTimeAtOrAfter
একইভাবে,startTimeBefore
প্যারামিটারটি ইঙ্গিত দেয় যে এপিআই প্রতিক্রিয়াতে কেবলমাত্র প্রতিবেদনের প্রথম ডেটা নির্দিষ্ট তারিখের আগে থাকলে প্রতিবেদনগুলি থাকা উচিত।পদ্ধতির
createdAfter
প্যারামিটারের বিপরীতে, যা প্রতিবেদনটি তৈরি হওয়ার সময়ের সাথে সম্পর্কিত, নতুন পরামিতিগুলি প্রতিবেদনের ডেটা সম্পর্কিত।reportType
রিসোর্সের নতুনsystemManaged
সম্পত্তিটি ইঙ্গিত দেয় যে সংস্থানটি কোনও সিস্টেম-পরিচালিত প্রতিবেদন বর্ণনা করে কিনা।reportTypes.list
পদ্ধতির নতুনincludeSystemManaged
প্যারামিটারটি নির্দেশ করে যে এপিআই প্রতিক্রিয়াটিতে সিস্টেম-পরিচালিত প্রতিবেদনগুলি অন্তর্ভুক্ত করা উচিত কিনা। প্যারামিটারের ডিফল্ট মানটিfalse
।
- ইউটিউব রিপোর্টিং এপিআই -তে,
sharing_service
মাত্রা এই নতুন মানগুলিকে সমর্থন করে:-
82
: আইওএস সিস্টেম ক্রিয়াকলাপ ডায়ালগ -
83
: গুগল ইনবক্স -
84
: অ্যান্ড্রয়েড ম্যাসেঞ্জার
-
- ইউটিউব অ্যানালিটিক্স এপিআই -তে,
sharingService
ডাইমেনশন এই নতুন মানগুলিকে সমর্থন করে:-
ANDROID_MESSENGER
: অ্যান্ড্রয়েড ম্যাসেঞ্জার -
INBOX
: গুগল ইনবক্স -
IOS_SYSTEM_ACTIVITY_DIALOG
: আইওএস সিস্টেম ক্রিয়াকলাপ ডায়ালগ
-
-
playback_location_type
টাইপ মাত্রা দুটি নতুন মাত্রার মান সমর্থন করে:-
7
: ডেটা ইউটিউব হোম পৃষ্ঠা বা হোম স্ক্রিনে, ব্যবহারকারীর সাবস্ক্রিপশন ফিডে বা অন্য কোনও ইউটিউব ব্রাউজিং বৈশিষ্ট্যে সংঘটিত দর্শনগুলির সাথে সম্পর্কিত। -
8
: ডেটা ইউটিউব অনুসন্ধান ফলাফল পৃষ্ঠায় সরাসরি সংঘটিত দর্শনগুলির সাথে সম্পর্কিত।
-
-
traffic_source_type
মাত্রা এখন18
মাত্রা মান হিসাবে সমর্থন করে। এই মানটি ইঙ্গিত দেয় যে ভিডিও ভিউগুলি এমন একটি পৃষ্ঠা থেকে উদ্ভূত হয়েছিল যা প্লেলিস্টে সমস্ত ভিডিও তালিকাভুক্ত করে। এই উত্সটি উত্স টাইপ14
থেকে পৃথক, যা ইঙ্গিত দেয় যে ভিডিওটি প্লেলিস্টের অংশ হিসাবে বাজানো হওয়ার সময় দৃশ্যগুলি ঘটেছিল। -
insightPlaybackLocationType
মাত্রা দুটি নতুন মাত্রা মান সমর্থন করে:-
BROWSE
: ডেটা ইউটিউব হোম পৃষ্ঠা বা হোম স্ক্রিনে, ব্যবহারকারীর সাবস্ক্রিপশন ফিডে বা অন্য কোনও ইউটিউব ব্রাউজিং বৈশিষ্ট্যে সংঘটিত দর্শনগুলির সাথে সম্পর্কিত। -
SEARCH
: ডেটা ইউটিউব অনুসন্ধান ফলাফল পৃষ্ঠায় সরাসরি সংঘটিত দর্শনগুলির সাথে সম্পর্কিত।
-
- The
insightTrafficSourceType
dimension now supportsYT_PLAYLIST_PAGE
as a dimension value. This value indicates that the video views originated from a page that lists all of the videos in a playlist. This source differs from thePLAYLIST
source type, which indicates that the views occurred while the video was being played as part of a playlist. - In the YouTube Reporting API, the
operating_system
dimension uses the value21
to identify views that take place via Chromecast. - In the YouTube Analytics API, the
operatingSystem
dimension uses the valueCHROMECAST
to identify views that take place via Chromecast. The YouTube Analytics API now supports three new playback detail dimensions , which can be used in a variety of channel and content owner reports:
-
liveOrOnDemand
: This dimension indicates whether the data in the report describes user activity that occurred during a live broadcast. -
subscribedStatus
: This dimension indicates whether the user activity metrics in the data are associated with viewers who were subscribed to the video's or playlist's channel. -
youtubeProduct
: This dimension identifies the YouTube property on which the user activity occurred. Possible values include the core YouTube website (or YouTube app), YouTube Gaming, and YouTube Kids.
The documentation has been updated to identify new playback detail reports that are available for channels and content owners . In addition, many other reports have been updated to note that one or more of these dimensions can optionally be used as dimensions and/or filters in those reports.
-
The format of the tables that explain the reports has changed to make it easier for you to identify valid combinations of dimensions, metrics, and filters that can be used to retrieve each report. The table below, which explains the "Device Type" report for channels, shows the new format:
বিষয়বস্তু মাত্রা: প্রয়োজন deviceType Use 0 or more day , liveOrOnDemand , subscribedStatus , youtubeProduct Metrics: Use 1 or more views , estimatedMinutesWatched ফিল্টার: Use 0 or 1 country , province , continent , subContinent Use 0 or 1 video , group Use 0 or more operatingSystem , liveOrOnDemand , subscribedStatus , youtubeProduct The terminology describing required and optional fields is explained in the documentation for channel and content owner reports.
The YouTube Analytics API now automatically drops entities that the API user cannot retrieve data for from filters that support multiple values (
video
,playlist
, andchannel
). Previously, the API server would have just returned an error if the API user could not access data for at least one of the specified items.For example, suppose a user submits an API request in which the
video
filter lists 20 video IDs. The user owns 18 of the videos. However, one videos ID identifies a video owned by another channel, and another ID identifies a video that was deleted and, therefore, no longer exists. In this case, instead of returning an error, the API server now drops the two videos that the user cannot access, and the API response contains data for the 18 videos that the API user owns.If you request data for an empty YouTube Analytics
group
, the API now returns an empty data set rather than an error.The YouTube Analytics API's
groupItems.insert
method now returns an unauthorized (403
HTTP response code) error if you try to add an entity to a group but you do not have access to that entity. Previously, the API would have allowed you to add the entity to the group, but later returned an unauthorized error when you tried to retrieve report data for that group.The YouTube Analytics API's
groups.list
method now supports pagination. If the API response does not contain all available groups, then the response'snextPageToken
parameter specifies a token that can be used to retrieve the next page of results. Set the method'spageToken
parameter to that value to retrieve additional results.The YouTube Analytics API now supports the
redPartnerRevenue
metric, which reports the total estimated revenue earned from YouTube Red subscriptions for the selected report dimensions. The metric's value reflects earnings from both music and non-music content and is subject to month-end adjustment.The YouTube Analytics API's list of content owner reports has been updated to identify the video reports that support the
redPartnerRevenue
metric:- মৌলিক পরিসংখ্যান
- সময় ভিত্তিক
- User geography
- Top videos – For this report,
redPartnerRevenue
is also supported as a sorting metric, which means you can retrieve a list of videos sorted by their YouTube Red earnings.
The top videos report definition for the YouTube Analytics API now reflects that this report also supports the following earnings metrics:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
, andimpressionBasedCpm
.The documentation for the YouTube Reporting API's
date
dimension has been corrected to reflect that dates reference the 24-hour period beginning at 12:00 am Pacific time (UTC-8). Previously, the documentation stated that the date began at 12:00 am (GMT).In addition, the YouTube Analytics API documentation has been updated to note that all date-related dimensions (
day
,7DayTotals
,30DayTotals
, andmonth
) refer to dates beginning at 12:00 am Pacific time (UTC-8).The YouTube Reporting API's
jobs.reports.list()
method now supports thecreatedAfter
query parameter. If specified, this parameter indicates that the API response should only list reports created after the specified date and time, including new reports with backfilled data. Note that the parameter value pertains to the time that the report is created and not the dates associated with the returned data.The parameter value is a timestamp in RFC3339 UTC "Zulu" format, accurate to microseconds. Example:
"2015-10-02T15:01:23.045678Z"
.The YouTube Reporting API best practices have also been updated to explain how you can use the
createdAfter
parameter to avoid repeatedly processing the same report.The definitions of the
job
resource'screateTime
property and thereport
resource'sstartTime
,endTime
, andcreateTime
properties have all been corrected to note that the property values are accurate to microseconds, not nanoseconds. In addition, all of the definitions now accurately reflect that the property value is a timestamp.The documentation for the YouTube Analytics API's
sharingService
dimension has been updated to include a list of possible dimension values. The list includes a number of newly supported services.The YouTube Reporting API's
sharing_service
dimension's definition has also been updated to list the newly supported values. The enum values that are greater than59
are the new ones in the list.The new YouTube Reporting API retrieves bulk data reports that contain YouTube Analytics data for a channel or content owner. It is designed for applications that can import large data sets and that provide tools to filter, sort, and mine that data.
Each YouTube Reporting API report contains a predefined set of dimensions and metrics. (YouTube Analytics API reports also use metrics and dimensions.) In a report, each row of data has a unique combination of dimension values. You can aggregate data across rows based on dimension values to calculate metrics for individual videos, countries, live videos, subcribed users, and so forth.
You can use the API to schedule reporting jobs, each of which identifies a report that YouTube should generate. Once you have set up a job, YouTube generates a daily report that can be asynchronously downloaded. Each report contains data for a unique, 24-hour period.
Although they are different APIs, the YouTube Analytics API and the YouTube Reporting API both enable developers to retrieve YouTube Analytics data. Since the APIs both provide access to similar data sets, the documentation for the two APIs is being published as a single set of documentation.
- The Guides tab in the documentation set contains information common to both APIs, including instructions for authorizing API requests.
- The Bulk reports tab contains reference documentation and other content specifically for the YouTube Reporting API.
- The Targeted queries tab contains reference documentation and other content specifically for the YouTube Analytics API.
- The Samples tab lists code samples available for either of the two APIs.
- The Tools tab lists additional resources available to help developers implement either of the two APIs.
The API documentation has been restructured in an effor to make the API easier to understand. As such, these changes do not describe new features:
The documentation now contains one page that lists all available channel reports and another that lists all available content owner reports . Previously, the documentation had separate pages for channel video reports, channel playlist reports, and so forth.
The new data model overview seeks to provide a clearer introduction to how the API works. Specifically, this document tries to better explain how YouTube uses metrics, dimensions, and filters to calculate report values.
The API's
reports.query
method, which you use to retrieve reports, is now documented separately. The information on that page had previously been on some other pages. The new page is designed to help you more easily identify the information you need to send to retrieve a report.
The new
adEarnings
metric includes total estimated earnings (net revenue) from all Google-sold advertising sources. It is not a core metric. The API supports theadEarnings
metric for any report that already supported theearnings
metric.In addition, the definition of the
earnings
metric has been corrected to reflect the fact that its value includes total estimated earnings from all Google-sold advertising sources as well as from non-advertising sources. Previously, the definition incorrectly indicated that the metric only included earnings from advertising sources.The
primaryAdGrossRevenue
metric has been deprecated. Instead, use thegrossRevenue
metric to retrieve revenue data.In addition to the deprecated
primaryAdGrossRevenue
metric, ad performance reports no longer support themonetizedPlaybacks
andplaybackBasedCpm
metrics. However, several video reports do still support those metrics.The API now supports two new metrics for video reports,
videosAddedToPlaylists
andvideosRemovedFromPlaylists
. The lists of video reports for channels and content owners have both been updated to identify the reports that support the new metrics.-
videosAddedToPlaylists
– The number of times that videos in the scope of the query were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists. -
videosRemovedFromPlaylists
– The number of times that videos in the scope of the query were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists.
Both metrics include default playlists like the "Watch Later" playlist. However, they do not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. Also note that these metrics reflect the absolute number of additions and deletions. So, if a user adds a video to a playlist, then removes it, and then adds it again, the metrics indicate that the video was added to two playlists and removed from one.
Data for these metrics is available as of October 1, 2014.
-
The
favoritesAdded
andfavoritesRemoved
metrics are both deprecated effective as of this announcement. These are both core metrics and subject to the Deprecation Policy set forth in the terms of service .The new
currency
parameter allows you to retrieve earnings metrics in a currency other than United States dollars (USD
). If the parameter is set, then the API converts values for theearnings
,grossRevenue
,playbackBasedCpm
, andimpressionBasedCpm
metrics to the specified currency. The values returned are estimates calculated using exchange rates that change on a daily basis.The parameter value is a three-letter, ISO 4217 currency code. The default value is
USD
. The parameter definition contains a list of supported currency codes.The API now supports the ability to create and manage YouTube Analytics groups as well as the ability to retrieve report data for those groups.
গ্রুপ তৈরি এবং পরিচালনা
This update introduces the
group
andgroupItem
resources for creating and managing groups.- The
group
resource represents an Analytics group, a custom collection of up to 200 channels, videos, playlists, or assets. The API supportslist
,insert
,update
, anddelete
methods for this resource. - The
groupItem
resource represents an item in an Analytics group. The API supportslist
,insert
, anddelete
methods for this resource.
So, for example, you could create a group using the
groups.insert
method and then add items to that group using thegroupItems.insert
method.- The
Retrieving report data for a group
The dimensions documentation has been updated to include the
group
dimension, which can be used as a filter for many channel reports and content owner reports . When you use thegroup
filter, the API returns data for all of the items in that group. Note that the API does not currently support the ability to create reports for asset groups.
See the YouTube Help Center for more information about YouTube Analytics groups.
The API no longer supports the
show
dimension.The API now supports the ability to specify multiple values for the
video
,playlist
,channel
, andshow
dimensions when those dimensions are used as filters . To specify multiple values, set thefilters
parameter value to a comma-separated list of the video, playlist, channel, or show IDs for which the API response should be filtered. The parameter value can specify up to 200 IDs.If you specify multiple values for the same filter, you can also add that filter to the list of dimensions that you specify for the request. This is true even if the filter is not listed as a supported dimension for a particular report. If you do add the filter to the list of dimensions, then the API also uses the filter values to group results.
See the
filters
parameter definition for complete details about this functionality.When retrieving a channel report, you can now retrieve data for the authenticated user's channel by setting the value of the
ids
parameter tochannel==MINE
. (You can also still set theids
parameter tochannel== CHANNEL_ID
to retrieve data for the specified channel.)The API now supports playlist reports, which contain statistics related to video views that occur in the context of a playlist. Playlist reports are available for channels and content owners .
All playlist reports support the
views
andestimatedMinutesWatched
metrics, and some also support theaverageViewDuration
metric.In addition, all playlist reports support the following new metrics. Note that each of these metrics only reflect playlist views that occurred on the web.
-
playlistStarts
: The number of times viewers initiated playback of a playlist. -
viewsPerPlaylistStart
: The average number of video views that occurred each time a playlist was initiated. -
averageTimeInPlaylist
: The estimated average amount of time, in minutes, that a viewer viewed videos in a playlist after the playlist was initiated.
Any request to retrieve a playlist report must use the
isCurated
filter, which must be set to1
(isCurated==1
).-
The API now supports an audience retention report. This report measures a video's ability to retain its audience. The report's new
elapsedVideoTimeRatio
dimension measures the amount of the video that has elapsed for the corresponding metric values:The
audienceWatchRatio
metric identifies the absolute ratio of viewers watching the video at the given point in the video. The ratio is calculated by comparing the number of times a portion of a video has been watched to the total number of views of the video.Note that a portion of a video could be watched more than once (or not at all) in a given video view. For example, if users rewind and watch the same portion of a video multiple times, then the absolute ratio for that portion of the video the could be greater than
1
.The
relativeRetentionPerformance
metric shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length. A value of 0 indicates that the video retains viewers worse than any other video of similar length, while a value of 1 indicates that the video retains viewers better than any other video of similar length. A median value of 0.5 indicates that half of the videos of similar length retain viewers better while half retain viewers worse.
You can also use the
audienceType
filter so that the report only returns data associated with organic views, views from TrueView in-stream ads, or views from TrueView in-display ads. (Organic views are the direct result of user action, such as a search for a video or a click on a suggested video.)The API supports several new metrics related to annotations. The metrics listed below can be retrieved with any reports that previously supported the
annotationClickThroughRate
andannotationCloseRate
metrics.-
annotationImpressions
: The total number of annotation impressions. -
annotationClickableImpressions
: The number of annotations that appeared and could be clicked. -
annotationClosableImpressions
: The number of annotations that appeared and could be closed. -
annotationClicks
: The total number of clicked annotations. -
annotationCloses
: The total number of closed annotations.
All of the new metrics are core metrics and are subject to the Deprecation Policy . However, note that data is available for the new metrics as of July 16, 2013. (Data for the
annotationClickThroughRate
andannotationCloseRate
metrics is available as of June 10, 2012.)-
GOOGLE_SEARCH
is no longer reported as a separate value for theinsightTrafficSourceType
dimension. Instead, referrals from Google search results are now attributed to theEXT_URL
traffic source type. As a result, it's also no longer possible to retrieve aninsightTrafficSourceDetail
report that sets theinsightTrafficSourceType
filter toGOOGLE_SEARCH
.The content owner reports document has been updated to reflect that the
subscribersGained
andsubscribersLost
metrics can now be retrieved for content claimed or uploaded by a content owner.The change is visible in the first basic stats report for content owners, which now supports the
claimedStatus
anduploaderType
filters.The sample requests document has been redesigned to group examples in categories, using a tab format similar to the one recently released for channel and content owner reports. With the new design, examples are grouped into the following categories:
- মৌলিক পরিসংখ্যান
- সময় ভিত্তিক
- ভৌগলিক
- Playback location
- ট্রাফিক উৎস
- ডিভাইস/ওএস
- ডেমোগ্রাফিক
- সামাজিক
- Earnings/Ads (for content owner reports only)
The sample requests document now includes new examples for retrieving province-specific data in either channel reports or content owner reports.
Province-specific metrics for US states and Washington DC : This report retrieves a province-by-province breakdown of view counts and other statistics for a channel's videos. The data covers US states and Washington DC The example uses the
province
dimension, and also uses thefilters
parameter to restrict the response to only include results for the United States.Viewer demographics in California (age group and gender) : This report retrieves statistics about the age group and gender of viewers in California who watched a channel's videos or, for content owner reports, a content owner's claimed content. This example uses the
filters
parameter to ensure the response only includes data for a particular province.
The definition of the
province
dimension has been updated to note that whenprovince
is included in thedimensions
parameter value, the request must also restrict data to the United States by includingcountry==US
in thefilters
parameter value.The documents that list the supported channel and content owner reports have been redesigned. Instead of providing a table that lists all possible reports, each document instead groups the reports into categories:
- মৌলিক পরিসংখ্যান
- সময় ভিত্তিক
- ভৌগলিক
- Playback location
- ট্রাফিক উৎস
- ডিভাইস/ওএস
- ডেমোগ্রাফিক
- সামাজিক
- সেরা ভিডিও
Each document displays these categories as a list of tabs, and you can click any tab to see the supported reports in that category.
The API now supports three new geographic dimensions:
province
,continent
, andsubContinent
.The
province
dimension lets you retrieve statistics for US states and for the District of Colombia. The API supports two uses for this dimension:The API supports two reports that break statistics down on a state-by-state basis. Both reports are available for channels and content owners .
- The core stats report provides several statistics, including view counts and estimated minutes watched.
- The time-based report provides the same statistics, but aggregates data on a daily, 7-day, 30-day, or monthly basis.
You can use the
filters
query parameter to restrict a report to only contain statistics for a particular state. Several reports support this type of filtering, including geographic reports, playback location reports, traffic source reports, device reports, operating system reports, demographic reports, and top-video reports.
The
continent
dimension specifies a United Nations (UN) statistical region code that identifies a continent. This dimension can only be used as a filter .The
subContinent
dimension specifies a United Nations (UN) statistical region code that identifies a sub-region of a continent. This dimension can also only be used as a filter.Since each sub-region is only associated with one continent, there is no need to also use the
continent
filter when you are using thesubContinent
filter. (In fact, the API will return an error if a request uses both dimensions.)
The documentation has been corrected so that the
insightTrafficSourceDetail
dimension does not include theinsightTrafficSourceType
valuePROMOTED
as a valid filter value.The YouTube Analytics API is now subject to the Deprecation Policy described in the Terms of Service . However, the API's non-core dimensions and non-core metrics are not subject to the Deprecation Policy. The dimensions and metrics pages have been updated to list core dimensions and core metrics. In addition, the definitions on those pages have been updated to explicitly identify core dimensions and metrics.
The API now supports
EXTERNAL_APP
as a value for theinsightPlaybackLocationType
dimension. In conjunction with this update, as of September 10, 2013, playbacks are no longer categorized asMOBILE
playbacks, though mobile playbacks that occurred before that date will still be categorized with that value.With this update, mobile playbacks are now classified as either
WATCH
,EMBEDDED
, orEXTERNAL_APP
playbacks, depending on the type of application where the playbacks occur.The API now supports
PLAYLIST
as a value for theinsightTrafficSourceType
dimension. The value indicates that video views were referred from a playlist. Previously, these views would have been classified using the dimension'sYT_OTHER_PAGE
category.The API now supports the ability to sort reports by multiple dimensions and metrics. The sample requests document contains a new example, Sorting requests by multiple dimensions/metrics , that demonstrates this functionality. The request retrieves traffic source data and has a
sort
parameter value ofday,-views
. Results are sorted chronologically, but within the result set for each day, the first row contains data for the traffic source that generated the most views, the second row contains data for the source with that generated the next highest amount of views, and so forth .The API now supports two new dimensions,
deviceType
andoperatingSystem
, which can be used to retrieve data about the devices where viewers are watching your videos. The API supports reports that use either or both dimensions.The
deviceType
report lets you retrieve view counts and estimated watch time for different types of devices, including desktop, mobile, and tablet devices. You can also use theoperatingSystem
filter to restrict the device type report to only contain statistics for devices running a specific operating system, such as Android or iOS .The
operatingSystem
report lets you retrieve view counts and estimated watch time for different operating systems, such as Android, iOS, Linux, and more. You can also use thedeviceType
filter to restrict the operating system report to only contain statistics for a specific type of device, such as mobile devices or tablets.
The new device type and operating system reports are available for channels and for content owners .
The sample requests document has been updated to include three device reports for channels and three device reports for content owners.
The
insightPlaybackLocationType
dimension may return the valueYT_OTHER
, which identifies views that are not classified using one of the dimension's other values.The content owner reports document has been updated to reflect that you can sort the top video report in descending order of earnings to identify videos with the highest earnings. This report is the first one listed in the second table of the User activity and earnings reports section.
YouTube no longer identifies experimental API features and services. Instead, we now provide a list of YouTube APIs that are subject to the deprecation policy .
The API now supports the ability to retrieve watch time metrics –
estimatedMinutesWatched
,averageViewDuration
, andaverageViewPercentage
– in conjunction with other metrics, including view metrics, engagement metrics, earnings metrics, and ad performance metrics.The lists of available channel reports and content owner reports have been updated to reflect this change. (The lists are actually shorter now since the watch time metrics can be retrieved as part of other listed reports.)
The Sample API requests document has also been updated.
The reports that use the
insightPlaybackLocationDetail
andinsightTrafficSourceDetail
dimensions have been enhanced in the following ways:They now support an optional
country
filter.Content owners can now retrieve these reports using any of the following new
filter
combinations. Note that all of these combinations also support the optionalcountry
filter.Playback location detail
-
channel,insightPlaybackLocationType==EMBEDDED
-
show,insightPlaybackLocationType==EMBEDDED
-
claimedStatus,insightPlaybackLocationType==EMBEDDED
-
uploaderType,insightPlaybackLocationType==EMBEDDED
-
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Traffic source detail
-
channel,insightTrafficSourceType
-
show,insightTrafficSourceType
-
claimedStatus,insightTrafficSourceType
-
uploaderType,insightTrafficSourceType
-
uploaderType,claimedStatus,insightTrafficSourceType
-
The new Sample API requests document provides examples that demonstrate how to retrieve many different types of reports using the YouTube Analytics API . Each example includes a brief description of the report that the request retrieves and then shows the dimensions, metrics, filters, and sort parameters for the request.
The
insightTrafficSourceType
dimension now supportsSUBSCRIBER
as a valid value. This value identifies video views that were referred from feeds on the YouTube homepage or from YouTube subscription features. If you filter based on this traffic source, theinsightTrafficSourceDetail
field will specify the homepage feed or other page from which views were referred.The API now supports two new metrics,
annotationClickThroughRate
andannotationCloseRate
, which are related to viewer interactions with annotations that display during your videos. The lists of channel reports and content owner reports have both been updated to identify the reports that support the new metrics.-
annotationClickThroughRate
– The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. -
annotationCloseRate
– The ratio of annotations that viewers closed to the total number of annotation impressions.
-
The API now supports earnings and ad performance metrics as well as new ad performance reports. The metrics and the reports are all accessible only to YouTube content partners who participate in the YouTube Partner Program .
The newly supported reports support playback-based ad performance metrics and impression-based ad performance metrics. See the content owner reports documentation for more information about ad performance reports.
The newly supported metrics are listed below. The list of content owner reports has been updated to identify the reports, including the two new reports, that support these metrics.
-
earnings
– Total estimated earnings from all Google-sold advertising sources. -
grossRevenue
– Estimated gross revenue from Google or DoubleClick partners. -
primaryAdGrossRevenue
– Estimated gross revenue, summed and classified under the primary ad type for the video playbacks that the report covers, from Google or DoubleClick partners. -
monetizedPlaybacks
– The number of playbacks that showed at least one ad impression. -
playbackBasedCpm
– Estimated gross revenue per thousand playbacks. -
impressions
– The number of verified ad impressions served. -
impressionBasedCpm
– Estimated gross revenue per thousand ad impressions.
Note: See the metric definitions for complete details.
-
Any request that retrieves earnings or ad performance metrics must send an authorization token that grants access using the new
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
scope.
The API documentation has been reorganized so that different types of reports are explained on separate pages. As such, there are now separate pages explaining the different types of channel reports and content owner reports .
The API's reference guide now has an examples section, which includes code samples that demonstrate how to call the API using the Java, JavaScript, Python, and Ruby client libraries. The JavaScript code sample is the same one discussed in detail in the sample application documentation.
The API reference guide now features the APIs Explorer , which enables you to call the API, see the API request, and retrieve real data in the response.
The API supports a number of new reports for both channels and content owners, which are described below. Each report is available as a channel report or a content owner report . The dimensions and metrics pages have also been updated accordingly.
The playback location report specifies the number of video views that took place on different types of pages or applications .
The playback location detail report identifies the embedded players that generated the most views for a specified video. It provides a more fine-grained view than the playback location report by identifying the URLs associated with the top embedded players.
The traffic source report identifies the number of videos views that originated from different types of referrers .
The traffic source detail report identifies the referrers that generated the most views for a specified video and a specified traffic source type. For example, this report could you the related videos that sent the most traffic to a specific video. This report is supported for several traffic sources .
Watch time reports provide the amount of time viewers spent watching your content. The reports can aggregate data for a specific time frame – day, previous seven days, previous 30 days, etc. – or country. If a report aggregates data by either day or country, it can also specify the average length of each video view as well as the average percentage of each video that users watched.
The YouTube Analytics API is now available to all developers. You can activate the API for your project, without having to first request access, from the Services panel in the APIs console .
The new Getting Started section outlines the prerequisites and basic steps for building an application that uses the YouTube Analytics API .
The new understanding quota usage section provides guidelines for optimizing your API quota usage. The API server calculates a query cost for each request, and that cost is deducted from your API usage quota. Since different types of reports may have greatly different query costs, you should plan to use your quota efficiently, and your application should only request the metrics and data that it actually needs.
The temporal dimensions section has been updated to explain that those dimensions indicate that an Analytics report should aggregate data based on a time period. The API now supports the following additional temporal dimensions:
-
7DayTotals
– Data in the report will be aggregated so that each row contains data for a seven-day period. -
30DayTotals
– Data in the report will be aggregated so that each row contains data for a 30-day period. -
month
– Data in the report will be aggregated by calendar month.
Similarly, the available reports section has been updated to reflect the API's support for reports that use these dimensions.
-
The reporting entity dimensions section has been updated to note that API requests to retrieve content owner reports must filter data using either one of these dimensions (
video
,channel
, orshow
) or a supported combination of theclaimedStatus
anduploaderType
dimensions.The API now supports two new sorting options for top-video reports . These reports, which are available as channel reports or content owner reports, contain metrics (views, comments, likes, etc.) on a per-country basis and break down those metrics by video. You can now sort these reports based on the number of users who subscribed to or unsubscribed from a channel from the video's watch page.
The definitions of the
subscribersGained
andsubscribersLost
metrics have been updated to explain that a channel can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. When these metrics appear in a video-specific report, they only include statistics from the specified video's watch page.
ইউটিউব রিপোর্টিং এপিআই তিনটি নতুন শেষ স্ক্রিন রিপোর্টের পাশাপাশি সেই প্রতিবেদনের জন্য নতুন মাত্রা এবং মেট্রিককে সমর্থন করে। প্রতিবেদনগুলি শেষ স্ক্রিনগুলির জন্য ছাপ এবং ক্লিক-মাধ্যমে পরিসংখ্যান সরবরাহ করে যা কোনও ভিডিও খেলা বন্ধ হওয়ার পরে প্রদর্শিত হয়।
ইউটিউব সহায়তা কেন্দ্রে আপনার ভিডিওগুলিতে শেষ স্ক্রিন যুক্ত করার বিষয়ে আরও বিশদ তথ্য রয়েছে।
নভেম্বর 8, 2016
এই আপডেটে ইউটিউব অ্যানালিটিক্স এপিআইতে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
অক্টোবর 27, 2016
ইউটিউব এখন স্বয়ংক্রিয়ভাবে ইউটিউবের স্রষ্টা স্টুডিওর প্রতিবেদন বিভাগে সংশ্লিষ্ট প্রতিবেদনে অ্যাক্সেসযুক্ত সামগ্রী মালিকদের জন্য সিস্টেম-পরিচালিত বিজ্ঞাপন উপার্জনের প্রতিবেদনের একটি সেট তৈরি করে। নতুন সিস্টেম-পরিচালিত এপিআই প্রতিবেদনগুলি ম্যানুয়ালি ডাউনলোডযোগ্য স্রষ্টা স্টুডিও রিপোর্টগুলিতেও উপলভ্য ডেটাগুলিতে প্রোগ্রাম্যাটিক অ্যাক্সেস সরবরাহ করার জন্য ডিজাইন করা হয়েছে।
সিস্টেম-পরিচালিত প্রতিবেদনগুলি ওভারভিউ নতুন প্রতিবেদনের একটি সংক্ষিপ্ত বিবরণ সরবরাহ করে এবং এপিআইয়ের মাধ্যমে সেগুলি পুনরুদ্ধার করার জন্য প্রক্রিয়াটি ব্যাখ্যা করে। ইউটিউব বিশ্লেষণের জন্য বাল্ক প্রতিবেদনগুলি পুনরুদ্ধার করার জন্য এই প্রক্রিয়াটি এর থেকে কিছুটা আলাদা যেহেতু অংশীদারদের প্রতিবেদনগুলি তৈরি করতে কাজের সময় নির্ধারণের প্রয়োজন হয় না।
আপনি এপিআইয়ের মাধ্যমে অ্যাক্সেস করতে পারেন এমন সিস্টেম-পরিচালিত প্রতিবেদনের একটি তালিকা অন্তর্ভুক্ত করার জন্য reportType
রিসোর্সের id
সম্পত্তি আপডেট করা হয়েছে:
সেপ্টেম্বর 27, 2016
দ্রষ্টব্য: এটি একটি অবমূল্যায়নের ঘোষণা।
ইউটিউব অ্যানালিটিক্স এপিআইয়ের uniques
মেট্রিককে হ্রাস করা হয়েছে। এটি কোনও মূল মেট্রিক নয় এবং এটি 31 অক্টোবর, 2016 পর্যন্ত সমর্থিত হবে।
15 সেপ্টেম্বর, 2016
এই আপডেটে নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই পরিবর্তনগুলি রয়েছে:
আগস্ট 19, 2016
এই আপডেটে নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই পরিবর্তন রয়েছে:
11 আগস্ট, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
আগস্ট 10, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:
জুলাই 18, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:
জুন 28, 2016
ইউটিউব অ্যানালিটিক্স এপিআই ডকুমেন্টেশনগুলি অসংখ্য চ্যানেল এবং সামগ্রীর মালিকের প্রতিবেদনে কার্ড মেট্রিকগুলির জন্য সমর্থন প্রতিফলিত করতে আপডেট করা হয়েছে। সদ্য সমর্থিত মেট্রিকগুলি হ'ল:
নিম্নলিখিত ধরণের প্রতিবেদনে মেট্রিকগুলি সমর্থিত:
জুন 22, 2016
এই আপডেটে নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই পরিবর্তনগুলি রয়েছে। প্রথম পরিবর্তনটি সাধারণভাবে এপিআইয়ের সাথে সম্পর্কিত এবং বাকী পরিবর্তনগুলি কেবল সামগ্রীর মালিকের প্রতিবেদনগুলিকে প্রভাবিত করে:
19 মে, 2016
এই আপডেটে নিম্নলিখিত ইউটিউব রিপোর্টিং এপিআই পরিবর্তনগুলি রয়েছে:
এপ্রিল 12, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে, এগুলি সমস্তই কেবল ইউটিউব রিপোর্টিং এপিআইকে প্রভাবিত করে:
28 মার্চ, 2016
ইউটিউব রিপোর্টিং এপিআই এবং ইউটিউব অ্যানালিটিক্স এপিআই এখন বেশ কয়েকটি অতিরিক্ত শেয়ারিং পরিষেবাদির জন্য পরিসংখ্যান প্রত্যাবর্তন করে।
16 মার্চ, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে, যা ইউটিউব রিপোর্টিং এপিআই এবং ইউটিউব অ্যানালিটিক্স এপিআই উভয়কেই প্রভাবিত করে:
ইউটিউব রিপোর্টিং এপিআই
ইউটিউব অ্যানালিটিক্স এপিআই
ফেব্রুয়ারী 8, 2016
The list of metrics supported for the YouTube Analytics API has been updated so that card metrics are no longer listed as supported metrics for that API. (None of that API's reports had been documented as supporting any of the card metrics.)
Note that you can still retrieve card metrics using the YouTube Reporting API, which supports those metrics for numerous channel and content owner reports.
জানুয়ারি 6, 2016
The YouTube Reporting API and YouTube Analytics API both now specifically identify views that occur via a Chromecast device.
ডিসেম্বর 21, 2015
In the documentation, the names of the annotation_clickable_impressions
and annotation_closable_impressions
metrics have been updated to match the names being returned in the reports. Previously, the names were documented as clickable_annotation_impressions
and closable_annotation_impressions
.
ডিসেম্বর 18, 2015
European Union (EU) laws require that certain disclosures must be given to and consents obtained from end users in the EU. Therefore, for end users in the European Union, you must comply with the EU User Consent Policy . We have added a notice of this requirement in our YouTube API Terms of Service .
15 ডিসেম্বর, 2015
This update contains the following changes, all of which affect the YouTube Analytics API:
নভেম্বর 10, 2015
This update contains the following changes:
অক্টোবর 29, 2015
This update contains the following changes:
অক্টোবর 8, 2015
This update contains the following changes:
সেপ্টেম্বর 24, 2015
This update contains the following changes:
আগস্ট 20, 2015
This update contains the following changes:
জুলাই 22, 2015
This update contains several changes, all of which only apply to content owners:
জুন 1, 2015
This update contains the following changes:
মার্চ 31, 2015
This update contains the following changes:
16 মার্চ, 2015
This update contains the following changes:
25 ফেব্রুয়ারি, 2015
This update contains the following changes:
ফেব্রুয়ারী 13, 2015
This update contains the following changes:
আগস্ট 28, 2014
This update contains the following changes:
জুলাই 16, 2014
This update contains the following changes:
31 জানুয়ারী, 2014
This update contains the following changes:
জানুয়ারি 16, 2014
This update contains the following changes:
6 জানুয়ারী, 2014
This update contains the following changes:
30 সেপ্টেম্বর, 2013
This update contains the following changes:
জুলাই 16, 2013
This update contains the following changes:
23 মে, 2013
This update contains the following changes:
10 মে, 2013
This update contains the following changes:
6 মে, 2013
This update contains the following changes:
3 মে, 2013
This update contains the following changes:
28 মার্চ, 2013
This update contains the following changes:
মার্চ 21, 2013
This update contains the following changes:
ফেব্রুয়ারী 4, 2013
This update contains the following changes:
নভেম্বর 14, 2012
This update contains the following changes:
অক্টোবর 2, 2012
This update contains the following changes:
সেপ্টেম্বর 12, 2012
This update contains the following changes: