Reports

একটি report রিসোর্স কোনো রিপোর্টের একটি নির্দিষ্ট দৃষ্টান্তকে শনাক্ত করে। এই রিসোর্সটি সেই সময়কালকে শনাক্ত করে, যে সময়ের ডেটা রিপোর্টটিতে থাকে, এবং সেইসাথে সেই URL-টিকেও শনাক্ত করে যেখান থেকে রিপোর্টটি ডাউনলোড করা যায়।

পদ্ধতি

নিচের সারণিতে 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" । এই প্রপার্টিটির একটি ভ্যালু থাকে যদি রিপোর্টের জবের সাথে যুক্ত রিপোর্ট টাইপটি ডেপ্রিকেটেড হয়ে যায় অথবা সেই জবের জন্য তৈরি করা রিপোর্টগুলো দীর্ঘ সময় ধরে ডাউনলোড করা না হয়। এই ভ্যালুটি সেই তারিখকে নির্দেশ করে, যার পরে ইউটিউব ওই জবের জন্য আর নতুন রিপোর্ট তৈরি করবে না। আপনার কোনো কাজে যদি একটি মেয়াদ শেষ হওয়ার তারিখ উল্লেখ থাকে, তবে সেই তারিখের পর রিপোর্টটির অনুরোধ বন্ধ করার জন্য আপনার সিস্টেমটি আপডেট করা উচিত। কিছু ক্ষেত্রে, একটি বিকল্প রিপোর্ট উপলব্ধ থাকতে পারে।
downloadUrl	string যে URL থেকে রিপোর্টটি ডাউনলোড করা যাবে। এই প্রপার্টি ভ্যালুটির সর্বোচ্চ দৈর্ঘ্য ১০০০ অক্ষর। রিপোর্টটি পেতে, এই URL-এ একটি HTTP GET অনুরোধ পাঠান। অনুরোধটিতে, আপনার অনুমোদন টোকেনটিকে হেডার ভ্যালু হিসেবে ব্যবহার করে Authorization HTTP Request হেডারটি সেট করুন। gzip ব্যবহার করে ডাউনলোড অনুরোধে gzip কম্প্রেশন সক্রিয় করার মাধ্যমে আপনি রিপোর্ট ডাউনলোড করার জন্য প্রয়োজনীয় ব্যান্ডউইথ কমাতে পারেন। যদিও এপিআই প্রতিক্রিয়াগুলি আনকমপ্রেস করার জন্য আপনার অ্যাপ্লিকেশনের অতিরিক্ত সিপিইউ সময়ের প্রয়োজন হবে, তবে কম নেটওয়ার্ক রিসোর্স ব্যবহারের সুবিধাটি সাধারণত সেই খরচের চেয়ে বেশি। gzip-এনকোডেড প্রতিক্রিয়া পেতে, নিম্নলিখিত উদাহরণে দেখানো অনুযায়ী Accept-Encoding HTTP অনুরোধ হেডারটি gzip এ সেট করুন: Accept-Encoding: gzip