Method: customers.reports.findSaasUsageProfiles

প্রদত্ত অনুসন্ধান এবং সাজানোর মানদণ্ডের উপর ভিত্তি করে প্রোফাইল অনুযায়ী শ্রেণীবদ্ধ গ্রাহকের SaaS ব্যবহারের প্রতিবেদন খুঁজুন।

HTTP অনুরোধ

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsageProfiles

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

পথের পরামিতি

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

string

আবশ্যক। "customers/C" বা "customers/my_customer" উপসর্গযুক্ত অস্পষ্ট গ্রাহক আইডি।

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

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

string

আবশ্যক। SaaS অ্যাপ্লিকেশনটির নাম (যেমন, ChatGPT , Gemini )।

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়া রিপোর্টের সর্বোচ্চ সংখ্যা। পরিষেবাটি এই মানের চেয়ে কম রিপোর্টও ফেরত দিতে পারে। যদি নির্দিষ্ট না করা হয়, তবে সর্বাধিক ১০০টি রিপোর্ট ফেরত দেওয়া হবে। সর্বোচ্চ মান হলো ২০০; ২০০-এর উপরের মানগুলোকে ২০০-তে রূপান্তরিত করা হবে।

pageToken

string

ঐচ্ছিক। একটি পেজ টোকেন, যা পূর্ববর্তী reports.findSaasUsageProfiles কল থেকে প্রাপ্ত। পরবর্তী পেজটি পুনরুদ্ধার করতে এটি প্রদান করুন।

filter

string

ঐচ্ছিক। ফেরত দেওয়া SaaS প্রোফাইল রিপোর্টগুলোকে সীমিত করার জন্য ফিল্টার এক্সপ্রেশন। সমর্থিত অপারেটরগুলো হলো: =, !=, <, <=, >, >=, :। লজিক্যাল অপারেটর AND, OR, এবং NOT সমর্থিত।

সমর্থিত ক্ষেত্রসমূহ:

  • ইমেইল
  • orgUnitId
  • ওএসপ্ল্যাটফর্ম
  • প্রথম নেভিগেশন সময়
  • শেষ নেভিগেশন সময়
orderBy

string

ঐচ্ছিক। SaaS প্রোফাইল রিপোর্টগুলো সাজানোর জন্য ব্যবহৃত এক্সপ্রেশন।

সমর্থিত ক্ষেত্রসমূহ:

  • ইমেইল
  • ওএসপ্ল্যাটফর্ম
  • প্রথম নেভিগেশন সময়
  • শেষ নেভিগেশন সময়

ডিফল্ট ক্রম হলো আরোহী। কোনো ফিল্ডের জন্য অবরোহী ক্রম নির্দিষ্ট করতে, শেষে 'desc' যোগ করুন।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

reports.findSaasUsageProfiles মেথডের প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
ক্ষেত্র
profileReports[]

object ( SaasUsageProfileReport )

SaaS ব্যবহারের প্রোফাইল রিপোর্টগুলোর তালিকা।

nextPageToken

string

একটি টোকেন, যা পরবর্তী পৃষ্ঠা আনার জন্য pageToken হিসেবে পাঠানো যেতে পারে। এই ক্ষেত্রটি বাদ দিলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

totalSize

string ( int64 format)

অনুরোধের সাথে মিলে যাওয়া SaaS ব্যবহারের প্রোফাইল রিপোর্টের মোট সংখ্যা।

অনুমোদনের পরিধি

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

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

সাসইউসেজপ্রোফাইলরিপোর্ট

প্রোফাইল অনুযায়ী গ্রুপ করা একটি একক SaaS রিপোর্ট এন্ট্রিকে উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
ক্ষেত্র
email

string

শুধুমাত্র আউটপুট। ব্যবহারকারীর ইমেইল।

profilePermanentId

string

শুধুমাত্র আউটপুট। প্রোফাইলটির স্থায়ী আইডি।

firstNavigationTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। এই প্রোফাইল থেকে অ্যাপ্লিকেশনটিতে প্রথমবার প্রবেশ করার সময়কার টাইমস্ট্যাম্প।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

lastNavigationTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। এই প্রোফাইল থেকে অ্যাপ্লিকেশনটিতে সর্বশেষ প্রবেশের সময়কার টাইমস্ট্যাম্প।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

orgUnitId

string

শুধুমাত্র আউটপুট। সাংগঠনিক ইউনিটের আইডি।

osPlatform

enum ( DeviceSystem )

শুধুমাত্র আউটপুট। ওএস প্ল্যাটফর্ম।

osVersion

string

শুধুমাত্র আউটপুট। ওএস সংস্করণ।