YouTube Reporting API

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

নিচের ধাপগুলোতে রিপোর্টিং জব শিডিউল করা এবং রিপোর্ট সংগ্রহ করার পদ্ধতি ব্যাখ্যা করা হয়েছে:

1. কোনো চ্যানেল বা কন্টেন্ট মালিক যে রিপোর্টগুলো পেতে পারেন, তার একটি তালিকা পেতে reportTypes.list() মেথডটি কল করুন।
2. কোনো চ্যানেল বা কন্টেন্ট মালিকের জন্য যে রিপোর্টটি তৈরি করা হবে, তা চিহ্নিত করতে jobs.create() মেথডটি কল করুন। এরপরে, তৈরি হতে থাকা রিপোর্টগুলোর তালিকা পুনরুদ্ধার বা পরিবর্তন করার জন্য আপনি API-এর jobs.list() এবং jobs.delete() ব্যবহার করতে পারেন।
3. কোনো নির্দিষ্ট কাজের জন্য তৈরি হওয়া রিপোর্টগুলোর তালিকা পেতে jobs.reports.list() মেথডটি কল করুন। রেসপন্সের প্রতিটি রিসোর্সে একটি downloadUrl প্রপার্টি থাকে, যা সেই URL নির্দিষ্ট করে যেখান থেকে রিপোর্টটি ডাউনলোড করা যাবে।
4. ডাউনলোড ইউআরএল থেকে রিপোর্টটি আনার জন্য একটি অনুমোদিত GET অনুরোধ পাঠান।

অনুমোদন

ইউটিউব রিপোর্টিং এপিআই-এর সকল অনুরোধ অবশ্যই অনুমোদিত হতে হবে। অনুমোদন নির্দেশিকায় ব্যাখ্যা করা হয়েছে কীভাবে OAuth 2.0 প্রোটোকল ব্যবহার করে অনুমোদন টোকেন সংগ্রহ করা যায়।

ইউটিউব রিপোর্টিং এপিআই অনুরোধগুলি নিম্নলিখিত অনুমোদন স্কোপগুলি ব্যবহার করে:

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

সম্পদের প্রকারভেদ

নিম্নলিখিত বিভাগগুলিতে এপিআই-এর রিসোর্স এবং মেথডগুলির সাধারণ বিবরণ দেওয়া হয়েছে। সারণিগুলিতে দেখানো সমস্ত মেথড ইউআরআই https://youtubereporting.googleapis.com এর সাপেক্ষে নির্ধারিত।

চাকরি

পদ্ধতি
create	POST /v1/jobs একটি রিপোর্টিং জব তৈরি করে। একটি রিপোর্টিং জব তৈরি করার মাধ্যমে, আপনি ইউটিউবকে দৈনিক ভিত্তিতে সেই রিপোর্টটি তৈরি করার নির্দেশ দিচ্ছেন। জবটি তৈরি করার ২৪ ঘণ্টার মধ্যে রিপোর্টটি পাওয়া যায়।
delete	DELETE /v1/jobs/{jobId} একটি রিপোর্টিং জব মুছে দেয়।
get	GET /v1/jobs/{jobId} কোনো চ্যানেল বা কন্টেন্ট মালিকের জন্য নির্ধারিত একটি নির্দিষ্ট রিপোর্টিং কাজ সম্পর্কিত তথ্য পুনরুদ্ধার করে।
list	GET /v1/jobs কোনো চ্যানেল বা কন্টেন্ট মালিকের জন্য নির্ধারিত রিপোর্টিং জবগুলোর তালিকা দেখায়। রেসপন্সের প্রতিটি রিসোর্সে একটি id প্রপার্টি থাকে, যা সেই আইডি নির্দিষ্ট করে যা ইউটিউব জবটিকে স্বতন্ত্রভাবে শনাক্ত করতে ব্যবহার করে। জবটির জন্য তৈরি হওয়া রিপোর্টগুলোর তালিকা পেতে বা জবটি ডিলিট করতে আপনার সেই আইডিটি প্রয়োজন হবে।

চাকরি.প্রতিবেদন

পদ্ধতি
get	GET /v1/jobs/{jobId}/reports/{reportId} একটি নির্দিষ্ট প্রতিবেদনের মেটাডেটা পুনরুদ্ধার করে।
list	GET /v1/jobs/{jobId}/reports নির্দিষ্ট রিপোর্টিং জবের জন্য তৈরি হওয়া রিপোর্টগুলোর তালিকা দেখায়।

রিপোর্টের প্রকারভেদ

পদ্ধতি
list	GET /v1/reportTypes চ্যানেল বা কন্টেন্টের মালিক যে ধরনের রিপোর্টগুলো পুনরুদ্ধার করতে পারেন, তার একটি তালিকা ফেরত দেয়।