API Reference

YouTube Analytics API আপনাকে একটি YouTube চ্যানেল বা বিষয়বস্তুর মালিকের জন্য YouTube Analytics ডেটা পুনরুদ্ধার করতে দেয়। API রিয়েল-টাইম কোয়েরি সমর্থন করে এবং API অনুরোধের পরামিতিগুলির উপর ভিত্তি করে একটি প্রতিবেদন তৈরি করে।

API দুই ধরনের ফাংশন সমর্থন করে:

  • রিপোর্ট পুনরুদ্ধার - API এর reports.query পদ্ধতি YouTube Analytics রিপোর্ট পুনরুদ্ধার করে।

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

এই পৃষ্ঠাটি API সংস্থান এবং পদ্ধতিগুলির একটি সংক্ষিপ্ত বিবরণ প্রদান করে যা এই ফাংশনগুলিকে সক্ষম করে৷

অনুমোদন

সমস্ত YouTube Analytics API অনুরোধ অনুমোদিত হতে হবে। অনুমোদন নির্দেশিকা ব্যাখ্যা করে কিভাবে অনুমোদন টোকেন পুনরুদ্ধার করতে OAuth 2.0 প্রোটোকল ব্যবহার করতে হয়।

YouTube Analytics API অনুরোধগুলি নিম্নলিখিত অনুমোদনের সুযোগগুলি ব্যবহার করে:

স্কোপ
https://www.googleapis.com/auth/yt-analytics.readonly আপনার YouTube সামগ্রীর জন্য YouTube বিশ্লেষণ প্রতিবেদনগুলি দেখুন৷ এই সুযোগ ব্যবহারকারীর কার্যকলাপ মেট্রিক্সে অ্যাক্সেস প্রদান করে, যেমন ভিউ সংখ্যা এবং রেটিং গণনা।
https://www.googleapis.com/auth/yt-analytics-monetary.readonly আপনার YouTube বিষয়বস্তুর জন্য YouTube Analytics আর্থিক প্রতিবেদনগুলি দেখুন৷ এই সুযোগ ব্যবহারকারী কার্যকলাপ মেট্রিক্স এবং আনুমানিক আয় এবং বিজ্ঞাপন কর্মক্ষমতা মেট্রিক্স অ্যাক্সেস প্রদান করে.
https://www.googleapis.com/auth/youtube আপনার YouTube অ্যাকাউন্ট পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, চ্যানেল মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।
https://www.googleapis.com/auth/youtubepartner YouTube এ YouTube সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।

রিপোর্ট পুনরুদ্ধার

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

পদ্ধতি HTTP অনুরোধ বর্ণনা
https://youtubeanalytics.googleapis.com/v2 এর সাথে সম্পর্কিত URI
query GET /reports একটি YouTube বিশ্লেষণ প্রতিবেদন পুনরুদ্ধার করে। প্রতিটি API অনুরোধ একটি চ্যানেল আইডি বা বিষয়বস্তুর মালিক, একটি শুরুর তারিখ, একটি সমাপ্তির তারিখ এবং অন্তত একটি মেট্রিক নির্দিষ্ট করতে ক্যোয়ারী প্যারামিটার ব্যবহার করে৷ এছাড়াও আপনি অতিরিক্ত ক্যোয়ারী প্যারামিটার প্রদান করতে পারেন, যেমন মাত্রা, ফিল্টার বা সাজানোর নির্দেশাবলী।
  • মেট্রিক্স হল ব্যবহারকারীর কার্যকলাপের পৃথক পরিমাপ, যেমন ভিডিও ভিউ বা রেটিং (পছন্দ এবং অপছন্দ)।
  • মাত্রাগুলি হল সাধারণ মানদণ্ড যা ডেটা একত্রিত করতে ব্যবহৃত হয়, যেমন ব্যবহারকারীর কার্যকলাপের তারিখ বা ব্যবহারকারীরা যে দেশে অবস্থিত ছিল। একটি প্রতিবেদনে, ডেটার প্রতিটি সারিতে মাত্রা মানগুলির একটি অনন্য সমন্বয় রয়েছে।
  • ফিল্টার হল মাত্রার মান যা পুনরুদ্ধার করা ডেটা নির্দিষ্ট করে। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট দেশ, একটি নির্দিষ্ট ভিডিও বা ভিডিওগুলির একটি গোষ্ঠীর জন্য ডেটা পুনরুদ্ধার করতে পারেন৷
সমর্থিত চ্যানেল রিপোর্ট এবং বিষয়বস্তুর মালিকের প্রতিবেদনের তালিকাগুলি মেট্রিক্স, মাত্রা এবং ফিল্টারগুলির বৈধ সমন্বয়কে সংজ্ঞায়িত করে৷

গ্রুপ ব্যবস্থাপনা

ইউটিউব অ্যানালিটিক্স গ্রুপ তৈরি এবং পরিচালনার জন্য API দুটি সংস্থান সরবরাহ করে:

গোষ্ঠী

একটি group রিসোর্স একটি YouTube অ্যানালিটিক্স গ্রুপের প্রতিনিধিত্ব করে, যা 500টি চ্যানেল, ভিডিও, প্লেলিস্ট বা সম্পদের একটি কাস্টম সংগ্রহ।

একটি গোষ্ঠীর সমস্ত আইটেম অবশ্যই একই ধরণের সংস্থান উপস্থাপন করতে হবে। উদাহরণস্বরূপ, আপনি এমন একটি গ্রুপ তৈরি করতে পারবেন না যেখানে 100টি ভিডিও এবং 100টি প্লেলিস্ট রয়েছে৷

একটি অ্যানালিটিক্স গ্রুপে শুধুমাত্র আপনার আপলোড করা বা দাবি করা বা আপনার প্রশাসিত একটি চ্যানেলের সাথে লিঙ্ক করা সম্পদ থাকতে পারে। ফলস্বরূপ, চ্যানেল মালিকরা ভিডিও এবং প্লেলিস্টের গ্রুপ তৈরি করতে পারেন। বিষয়বস্তুর মালিকরা ভিডিও, প্লেলিস্ট, চ্যানেল বা সম্পদের গ্রুপ তৈরি করতে পারে।

এই সংস্থান সম্পর্কে আরও তথ্যের জন্য, এর সংস্থান উপস্থাপনা এবং বৈশিষ্ট্যের তালিকা দেখুন।

পদ্ধতি HTTP অনুরোধ বর্ণনা
https://youtubeanalytics.googleapis.com/v2 এর সাথে সম্পর্কিত URI
list GET /groups API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা প্রদান করে৷ উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক গোষ্ঠী পুনরুদ্ধার করতে পারেন।
insert POST /groups একটি YouTube Analytics গ্রুপ তৈরি করে। একটি গ্রুপ তৈরি করার পরে, গ্রুপে আইটেম যোগ করতে groupItems.insert পদ্ধতি ব্যবহার করুন।
update PUT /groups একটি গ্রুপের জন্য মেটাডেটা পরিবর্তন করে। বর্তমানে, একমাত্র সম্পত্তি যা আপডেট করা যেতে পারে তা হল গ্রুপের শিরোনাম। (গ্রুপ আইটেম যোগ করতে এবং সরাতে groupItems.insert এবং groupItems.delete ব্যবহার করুন।)
delete DELETE /groups একটি গ্রুপ মুছে দেয়।

GroupItems

একটি groupItem সংস্থান একটি YouTube অ্যানালিটিক্স গ্রুপের একটি আইটেম প্রতিনিধিত্ব করে।

এই সংস্থান সম্পর্কে আরও তথ্যের জন্য, এর সংস্থান উপস্থাপনা এবং বৈশিষ্ট্যের তালিকা দেখুন।

পদ্ধতি HTTP অনুরোধ বর্ণনা
https://youtubeanalytics.googleapis.com/v2 এর সাথে সম্পর্কিত URI
list GET /groupItems API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গ্রুপ আইটেমগুলির একটি সংগ্রহ প্রদান করে৷
insert POST /groupItems একটি গ্রুপ আইটেম তৈরি করে।
delete DELETE /groupItems একটি গ্রুপ থেকে একটি আইটেম সরান.