YouTube Reporting API - System-Managed Reports

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

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

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

রিপোর্ট পুনরুদ্ধার করা হচ্ছে

নিম্নলিখিত পদক্ষেপগুলি API-এর মাধ্যমে কীভাবে সিস্টেম-পরিচালিত প্রতিবেদনগুলি পুনরুদ্ধার করতে হয় তা ব্যাখ্যা করে৷

ধাপ 1: অনুমোদনের শংসাপত্র পুনরুদ্ধার করুন

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

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

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

ধাপ 2: পছন্দসই প্রতিবেদনের জন্য কাজের আইডি পুনরুদ্ধার করুন

সিস্টেম-পরিচালিত কাজের তালিকা পুনরুদ্ধার করতে jobs.list পদ্ধতিতে কল করুন। includeSystemManaged প্যারামিটারটি true এ সেট করুন।

প্রতিটি রিটার্ন করা Job রিসোর্সে reportTypeId প্রপার্টি সেই কাজের সাথে যুক্ত সিস্টেম-ম্যানেজড রিপোর্টের ধরন শনাক্ত করে। নিম্নলিখিত ধাপে আপনার আবেদনের জন্য একই সংস্থান থেকে id সম্পত্তি মান প্রয়োজন।

রিপোর্ট নথিতে উপলব্ধ রিপোর্ট, তাদের রিপোর্টের ধরন আইডি, এবং যে ক্ষেত্রগুলি রয়েছে তা তালিকাভুক্ত করে। সমর্থিত রিপোর্ট প্রকারের তালিকা পুনরুদ্ধার করতে আপনি reportTypes.list পদ্ধতিও ব্যবহার করতে পারেন।

ধাপ 3: রিপোর্টের ডাউনলোড URL পুনরুদ্ধার করুন

কাজের জন্য তৈরি করা রিপোর্টের তালিকা পুনরুদ্ধার করতে jobs.reports.list পদ্ধতিতে কল করুন। অনুরোধে, আপনি যে রিপোর্টটি পুনরুদ্ধার করতে চান তার কাজের আইডিতে jobId প্যারামিটার সেট করুন।

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

  • এপিআই শুধুমাত্র একটি নির্দিষ্ট সময়ের পরে তৈরি করা রিপোর্টগুলি ফেরত দেবে তা নির্দেশ করার জন্য createdAfter প্যারামিটার ব্যবহার করুন। এই পরামিতিটি নিশ্চিত করতে ব্যবহার করা যেতে পারে যে API শুধুমাত্র সেই রিপোর্টগুলি ফেরত দেয় যা আপনি ইতিমধ্যে প্রক্রিয়া করেননি।

  • startTimeBefore প্যারামিটার ব্যবহার করে নির্দেশ করুন যে API প্রতিক্রিয়াতে শুধুমাত্র রিপোর্ট থাকা উচিত যদি রিপোর্টের প্রথমতম ডেটা নির্দিষ্ট তারিখের আগে হয়। যেখানে createdAfter পরামিতি প্রতিবেদনটি তৈরি করার সময় সম্পর্কিত, এই তারিখটি প্রতিবেদনের ডেটার সাথে সম্পর্কিত।

  • startTimeAtOrAfter প্যারামিটার ব্যবহার করে নির্দেশ করুন যে API প্রতিক্রিয়াতে শুধুমাত্র রিপোর্ট থাকা উচিত যদি রিপোর্টের প্রথমতম ডেটা নির্দিষ্ট তারিখে বা তার পরে থাকে। startTimeBefore প্যারামিটারের মতো, এই প্যারামিটারের মান রিপোর্টের ডেটার সাথে মিলে যায় এবং রিপোর্ট তৈরির সময় নয়।

API প্রতিক্রিয়াতে সেই কাজের জন্য Report সংস্থানগুলির একটি তালিকা রয়েছে৷ প্রতিটি সংস্থান এমন একটি প্রতিবেদনকে বোঝায় যাতে একটি অনন্য সময়ের জন্য ডেটা থাকে।

  • রিসোর্সের startTime এবং endTime বৈশিষ্ট্যগুলি রিপোর্টের ডেটা কভার করার সময়কালকে চিহ্নিত করে৷
  • রিসোর্সের downloadUrl প্রপার্টি সেই URLটিকে চিহ্নিত করে যেখান থেকে রিপোর্ট আনা যেতে পারে।

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

ধাপ 4: প্রতিবেদনটি ডাউনলোড করুন

প্রতিবেদনটি পুনরুদ্ধার করতে ধাপ 4 এ প্রাপ্ত downloadUrl এ একটি HTTP GET অনুরোধ পাঠান।

রিপোর্ট প্রক্রিয়াকরণ

সেরা অনুশীলন

যে অ্যাপ্লিকেশনগুলি YouTube রিপোর্টিং API ব্যবহার করে তাদের সর্বদা এই অনুশীলনগুলি অনুসরণ করা উচিত:

  • রিপোর্টের কলামের ক্রম নির্ধারণ করতে রিপোর্টের হেডার সারি ব্যবহার করুন। উদাহরণ স্বরূপ, অনুমান করবেন না যে ভিউ একটি রিপোর্টে প্রথম মেট্রিক প্রত্যাবর্তিত হবে কারণ এটি একটি প্রতিবেদনের বিবরণে তালিকাভুক্ত প্রথম মেট্রিক। পরিবর্তে, কোন কলামে সেই ডেটা রয়েছে তা নির্ধারণ করতে প্রতিবেদনের হেডার সারিটি ব্যবহার করুন৷

  • একই রিপোর্ট বারবার প্রসেসিং এড়াতে আপনার ডাউনলোড করা রিপোর্টের রেকর্ড রাখুন। নিম্নলিখিত তালিকাটি এটি করার কয়েকটি উপায়ের পরামর্শ দেয়।

    • reports.list পদ্ধতিতে কল করার সময়, শুধুমাত্র একটি নির্দিষ্ট তারিখের পরে তৈরি রিপোর্ট পুনরুদ্ধার করতে createAfter প্যারামিটার ব্যবহার করুন। (প্রথমবার রিপোর্ট পুনরুদ্ধার করার createdAfter পরামিতি বাদ দিন।)

      প্রতিবার যখন আপনি রিপোর্টগুলি পুনরুদ্ধার করবেন এবং সফলভাবে প্রক্রিয়া করবেন, সেই তারিখ এবং সময়ের সাথে সম্পর্কিত টাইমস্ট্যাম্প সংরক্ষণ করুন যখন সেই রিপোর্টগুলির মধ্যে নতুনটি তৈরি হয়েছিল৷ তারপরে, প্রতিটি পরপর কলে reports.list পদ্ধতিতে createdAfter প্যারামিটার মান আপডেট করুন যাতে আপনি প্রত্যেকবার API কল করার সময় ব্যাকফিল করা ডেটা সহ নতুন রিপোর্ট সহ শুধুমাত্র নতুন রিপোর্ট পুনরুদ্ধার করছেন।

      একটি সুরক্ষা হিসাবে, একটি রিপোর্ট পুনরুদ্ধার করার আগে, রিপোর্টের আইডি আপনার ডাটাবেসে ইতিমধ্যেই তালিকাভুক্ত করা হয়নি তা নিশ্চিত করতে পরীক্ষা করুন৷

    • আপনার ডাউনলোড করা এবং প্রক্রিয়া করা প্রতিটি রিপোর্টের জন্য আইডি সংরক্ষণ করুন। এছাড়াও আপনি অতিরিক্ত তথ্য সঞ্চয় করতে পারেন যেমন তারিখ এবং সময় যখন প্রতিটি প্রতিবেদন তৈরি করা হয়েছিল বা প্রতিবেদনের startTime এবং endTime , যা একসাথে সেই সময়কালকে চিহ্নিত করে যার জন্য রিপোর্টে ডেটা রয়েছে৷ YouTube Analytics-এর জন্য বাল্ক ডেটা পুনরুদ্ধার করে এমন রিপোর্টগুলির জন্য, প্রতিটি কাজের সম্ভবত অনেকগুলি রিপোর্ট থাকবে কারণ প্রতিটি রিপোর্টে 24-ঘন্টা সময়ের জন্য ডেটা থাকে৷ সিস্টেম-পরিচালিত কাজগুলি যা দীর্ঘ সময়ের কভার করে সেগুলির কম রিপোর্ট থাকবে৷

      আপনাকে এখনও ডাউনলোড এবং আমদানি করতে হবে এমন রিপোর্ট শনাক্ত করতে রিপোর্ট আইডি ব্যবহার করুন। যাইহোক, যদি দুটি নতুন রিপোর্টের startTime এবং endTime প্রপার্টির মান একই থাকে, শুধুমাত্র নতুন createTime মান সহ রিপোর্ট আমদানি করুন।

রিপোর্ট বৈশিষ্ট্য

এপিআই রিপোর্টগুলি ভার্সন করা হয় .csv (কমা-বিভক্ত মান) ফাইল যেগুলির নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

  • প্রতিটি রিপোর্টে রিপোর্টের শুরুর তারিখে প্রশান্ত মহাসাগরীয় সময় 12:00 am থেকে রিপোর্টের শেষ তারিখে 11:59 pm প্রশান্ত মহাসাগরীয় সময় পর্যন্ত স্থায়ী একটি অনন্য সময়ের জন্য ডেটা থাকে৷

  • রিপোর্ট তথ্য বাছাই করা হয় না.