Reports

একটি report সংস্থান একটি প্রতিবেদনের একটি নির্দিষ্ট উদাহরণ সনাক্ত করে। রিসোর্সটি সেই সময়কালকে চিহ্নিত করে যার জন্য রিপোর্টে ডেটা রয়েছে সেইসাথে ইউআরএল যেখান থেকে রিপোর্ট ডাউনলোড করা যেতে পারে।

পদ্ধতি

নিম্নলিখিত সারণী পদ্ধতিগুলি দেখায় যা API report সংস্থানগুলির জন্য সমর্থন করে৷

পদ্ধতি
get	একটি নির্দিষ্ট প্রতিবেদনের জন্য মেটাডেটা পুনরুদ্ধার করে।
list	নির্দিষ্ট রিপোর্টিং কাজের জন্য তৈরি করা রিপোর্টগুলিকে তালিকাভুক্ত করে৷

JSON সম্পদ প্রতিনিধিত্ব

নীচের JSON কাঠামোটি একটি report সংস্থানের বিন্যাস দেখায়:

{
  "id": string,
  "jobId": string,
  "startTime": timestamp,
  "endTime": timestamp,
  "createTime": timestamp,
  "jobExpireTime": timestamp,
  "downloadUrl": string
}

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
id	string ইউটিউব রিপোর্টটিকে অনন্যভাবে শনাক্ত করার জন্য যে আইডি বরাদ্দ করে। প্রতিটি রিপোর্ট একটি একক কাজের সাথে যুক্ত, যদিও একটি চাকরি অনেক রিপোর্ট আইডির সাথে যুক্ত হতে পারে।
jobId	string যে চাকরির আইডি থেকে এই প্রতিবেদন তৈরি করা হয়েছে।
startTime	timestamp প্রতিবেদনের উদাহরণ কভার করার সময়কালের শুরু। অন্তর্ভুক্ত মান হল RFC3339 UTC "জুলু" বিন্যাসে একটি টাইমস্ট্যাম্প, যা মাইক্রোসেকেন্ডে নির্ভুল। উদাহরণ: "2015-10-02T15:01:23.045678Z" ।
endTime	timestamp প্রতিবেদনের উদাহরণ কভার করার সময়কালের শেষ। একচেটিয়া মান হল RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, যা মাইক্রোসেকেন্ডে নির্ভুল। উদাহরণ: "2015-10-02T15:01:23.045678Z" ।
createTime	timestamp তারিখ এবং সময় যে কাজটি তৈরি করা হয়েছিল। সম্পত্তির মান হল RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, মাইক্রোসেকেন্ডের জন্য সঠিক। উদাহরণ: "2015-10-02T15:01:23.045678Z" ।
jobExpireTime	timestamp রিপোর্টের সাথে যুক্ত চাকরির মেয়াদ শেষ বা মেয়াদ শেষ হওয়ার তারিখ এবং সময়। সম্পত্তির মান হল RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, মাইক্রোসেকেন্ডের জন্য সঠিক। উদাহরণ: "2015-10-02T15:01:23.045678Z" । এই সম্পত্তির একটি মান আছে যদি হয় প্রতিবেদনের কাজের সাথে সম্পর্কিত প্রতিবেদনের ধরনটি অবমূল্যায়ন করা হয় বা সেই কাজের জন্য তৈরি করা প্রতিবেদনগুলি দীর্ঘ সময়ের জন্য ডাউনলোড না করা হয়। মানটি সেই তারিখটিকে চিহ্নিত করে যার পরে YouTube আর চাকরির জন্য নতুন প্রতিবেদন তৈরি করবে না। আপনার যদি এমন চাকরি থাকে যা মেয়াদ শেষ হওয়ার তারিখ চিহ্নিত করে, তাহলে সেই তারিখের মধ্যে রিপোর্টের অনুরোধ করা বন্ধ করতে আপনার সিস্টেম আপডেট করা উচিত। কিছু ক্ষেত্রে, একটি প্রতিস্থাপন রিপোর্ট পাওয়া যেতে পারে।
downloadUrl	string যে URL থেকে প্রতিবেদনটি ডাউনলোড করা যাবে। সম্পত্তি মান সর্বোচ্চ 1000 অক্ষর আছে. রিপোর্ট পুনরুদ্ধার করতে, এই URL-এ একটি HTTP GET অনুরোধ পাঠান। অনুরোধে, হেডার মান হিসাবে আপনার অনুমোদন টোকেন ব্যবহার করে Authorization HTTP অনুরোধ শিরোনাম সেট করুন। জিজিপ ব্যবহার করে আপনি ডাউনলোডের অনুরোধে gzip কম্প্রেশন সক্ষম করে রিপোর্ট ডাউনলোড করার জন্য প্রয়োজনীয় ব্যান্ডউইথ কমাতে পারেন। যদিও আপনার অ্যাপ্লিকেশানের API প্রতিক্রিয়াগুলিকে কম্প্রেস করতে অতিরিক্ত CPU সময়ের প্রয়োজন হবে, কম নেটওয়ার্ক সংস্থানগুলি ব্যবহার করার সুবিধা সাধারণত সেই খরচের চেয়ে বেশি। একটি gzip-এনকোডেড প্রতিক্রিয়া পেতে, নিম্নলিখিত উদাহরণে দেখানো হিসাবে gzip এ Accept-Encoding HTTP অনুরোধ শিরোনাম সেট করুন: Accept-Encoding: gzip