Method: userUsageReport.get

একটি প্রতিবেদন পুনরুদ্ধার করে যা অ্যাকাউন্ট সহ ব্যবহারকারীদের একটি সেটের জন্য বৈশিষ্ট্য এবং পরিসংখ্যানের একটি সংগ্রহ৷ আরও তথ্যের জন্য, ব্যবহারকারীর ব্যবহার প্রতিবেদন নির্দেশিকা দেখুন। ব্যবহারকারীর প্রতিবেদনের পরামিতি সম্পর্কে আরও তথ্যের জন্য, ব্যবহারকারীদের ব্যবহারের পরামিতি রেফারেন্স নির্দেশিকা দেখুন।

HTTP অনুরোধ

GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
userKey or all

string

প্রোফাইল আইডি বা ব্যবহারকারীর ইমেল প্রতিনিধিত্ব করে যার জন্য ডেটা ফিল্টার করা উচিত। all তথ্য বা ব্যবহারকারীর অনন্য Google Workspace প্রোফাইল আইডি বা তাদের প্রাথমিক ইমেল ঠিকানার জন্য userKey হতে পারে। মুছে ফেলা ব্যবহারকারী হতে হবে না। একটি মুছে ফেলা ব্যবহারকারীর জন্য, showDeleted=true সহ ডিরেক্টরি API-তে users.list কল করুন, তারপর userKey হিসাবে ফেরত ID ব্যবহার করুন।

date

string

UTC-8:00 (প্যাসিফিক স্ট্যান্ডার্ড টাইম) এর উপর ভিত্তি করে ব্যবহারের তারিখটি উপস্থাপন করে। টাইমস্ট্যাম্পটি ISO 8601 ফর্ম্যাটে , yyyy-mm-dd ।

ক্যোয়ারী প্যারামিটার

পরামিতি
customerId

string

ডেটা পুনরুদ্ধার করার জন্য গ্রাহকের অনন্য আইডি।

filters

string

filters ক্যোয়ারী স্ট্রিং হল একটি অ্যাপ্লিকেশনের ইভেন্ট প্যারামিটারের একটি কমা-বিভক্ত তালিকা যেখানে প্যারামিটারের মান একটি রিলেশনাল অপারেটর দ্বারা ম্যানিপুলেট করা হয়। filters ক্যোয়ারী স্ট্রিংটিতে সেই অ্যাপ্লিকেশনটির নাম রয়েছে যার ব্যবহার প্রতিবেদনে ফেরত দেওয়া হয়েছে। ব্যবহারকারীদের ব্যবহারের প্রতিবেদনের জন্য অ্যাপ্লিকেশন মানগুলির মধ্যে accounts , docs এবং gmail অন্তর্ভুক্ত রয়েছে।

ফিল্টারগুলি ফর্মে রয়েছে [application name]:[parameter name][relational operator][parameter value],...

এই উদাহরণে, অনুরোধের ক্যোয়ারী স্ট্রিং (%3C%3E) এ <> 'not equal to' অপারেটরটি URL-এনকোড করা হয়েছে:

GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z

রিলেশনাল অপারেটর অন্তর্ভুক্ত:

  • == - 'সমান'।
  • <> - 'সমান নয়'। এটি ইউআরএল-এনকোডেড (%3C%3E)।
  • < - 'এর চেয়ে কম'। এটি URL-এনকোডেড (%3C)।
  • <= - 'এর চেয়ে কম বা সমান'। এটি URL-এনকোডেড (%3C=)।
  • > - 'এর চেয়ে বড়'। এটি ইউআরএল-এনকোডেড (%3E)।
  • >= - 'এর চেয়ে বড় বা সমান'। এটি URL-এনকোডেড (%3E=)।

maxResults

integer ( uint32 format)

প্রতিটি প্রতিক্রিয়া পৃষ্ঠায় কতগুলি কার্যকলাপ রেকর্ড দেখানো হয়েছে তা নির্ধারণ করে। উদাহরণস্বরূপ, যদি অনুরোধটি maxResults=1 সেট করে এবং প্রতিবেদনে দুটি ক্রিয়াকলাপ থাকে, প্রতিবেদনটিতে দুটি পৃষ্ঠা থাকে। প্রতিক্রিয়ার nextPageToken সম্পত্তিতে দ্বিতীয় পৃষ্ঠার টোকেন রয়েছে।
maxResults ক্যোয়ারী স্ট্রিং ঐচ্ছিক।

orgUnitID

string

রিপোর্ট করার জন্য সাংগঠনিক ইউনিটের আইডি। ব্যবহারকারীর কার্যকলাপ শুধুমাত্র নির্দিষ্ট সাংগঠনিক ইউনিটের অন্তর্গত ব্যবহারকারীদের জন্য দেখানো হবে।

pageToken

string

পরবর্তী পৃষ্ঠা নির্দিষ্ট করতে টোকেন। একাধিক পৃষ্ঠা সহ একটি প্রতিবেদনের প্রতিক্রিয়াতে nextPageToken বৈশিষ্ট্য রয়েছে। রিপোর্টের পরবর্তী পৃষ্ঠা পাওয়ার জন্য আপনার ফলো-অন অনুরোধে, pageToken ক্যোয়ারী স্ট্রিং-এ nextPageToken মান লিখুন।

parameters

string

parameters ক্যোয়ারী স্ট্রিং হল ইভেন্ট প্যারামিটারের একটি কমা-বিভক্ত তালিকা যা রিপোর্টের ফলাফলগুলিকে পরিমার্জিত করে। পরামিতি একটি নির্দিষ্ট অ্যাপ্লিকেশনের সাথে যুক্ত। গ্রাহকদের ব্যবহারের প্রতিবেদনের জন্য অ্যাপ্লিকেশন মানগুলির মধ্যে রয়েছে accounts , app_maker , apps_scripts , calendar , classroom , cros , docs , gmail , gplus , device_management , meet , এবং sites ।
একটি parameters ক্যোয়ারী স্ট্রিং CSV ফর্মে রয়েছে app_name1:param_name1, app_name2:param_name2 ।

groupIdFilter

string

কমা বিভক্ত গ্রুপ আইডি (অস্পষ্ট) যেখানে ব্যবহারকারীর কার্যকলাপগুলি ফিল্টার করা হয়, অর্থাৎ প্রতিক্রিয়াটিতে শুধুমাত্র সেই ব্যবহারকারীদের কার্যকলাপ থাকবে যারা এখানে উল্লিখিত গ্রুপ আইডিগুলির অন্তত একটির অংশ। বিন্যাস: "id:abc123, id:xyz456"

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে UsageReports এর একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।