Method: customers.reports.findSaasUsage

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

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string

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

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

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

integer

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

pageToken

string

ঐচ্ছিক। পূর্ববর্তী FindSaasUsageReports কল থেকে প্রাপ্ত একটি পেজ টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন।

পেজিনেশন করার সময়, FindSaasUsageReports এ প্রদত্ত অন্য সকল প্যারামিটার অবশ্যই সেই কলের সাথে মিলতে হবে যা পেজ টোকেনটি প্রদান করেছে।

filter

string

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

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

  • অ্যাপ
  • orgUnitId
  • প্রথম নেভিগেশন সময়
  • শেষ নেভিগেশন সময়
  • বিভাগ
  • সংগঠন
  • প্রতিষ্ঠার বছর
  • সদর দপ্তর
  • প্রাথমিক ডোমেইন
  • ডোমেইন
  • এনক্রিপশন প্রোটোকল
  • পরিদর্শনের সংখ্যা
  • স্বতন্ত্র ব্যবহারকারীর সংখ্যা
  • স্বতন্ত্র ব্রাউজার সংখ্যা
  • কন্টেন্ট ট্রান্সফার সংখ্যা

উদাহরণ: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100

orderBy

string

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

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

  • অ্যাপ
  • বিভাগ
  • সংগঠন
  • প্রতিষ্ঠার বছর
  • সদর দপ্তর
  • প্রাথমিক ডোমেইন
  • পরিদর্শনের সংখ্যা
  • স্বতন্ত্র ব্যবহারকারীর সংখ্যা
  • স্বতন্ত্র ব্রাউজার সংখ্যা
  • কন্টেন্ট ট্রান্সফার সংখ্যা

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

উদাহরণ: visitsCount desc

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

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

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

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

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

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

object ( SaasUsageReport )

SaaS ব্যবহারের প্রতিবেদনগুলোর তালিকা।

nextPageToken

string

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

totalSize

string ( int64 format)

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

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

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

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

সাস ব্যবহারের প্রতিবেদন

এটি একটি একক SaaS রিপোর্ট এন্ট্রিকে উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
ক্ষেত্র
app

string

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটির নাম।

orgUnitId

string

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

category

string

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটির বিভাগ।

organization

string

শুধুমাত্র আউটপুট। যে সংস্থাটি অ্যাপ্লিকেশনটি তৈরি করে।

foundedYear

integer

শুধুমাত্র আউটপুট। সংস্থাটি প্রতিষ্ঠিত হওয়ার বছর।

headquarters

string

শুধুমাত্র আউটপুট। সংস্থাটির সদর দপ্তরের অবস্থান।

primaryDomain

string

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটির প্রাথমিক ডোমেইন।

domains[]

string

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

encryptionProtocols[]

string

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটি অ্যাক্সেস করতে ব্যবহৃত এনক্রিপশন প্রোটোকলগুলোর একটি তালিকা।

visitsCount

string ( int64 format)

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটিতে মোট পরিদর্শনের সংখ্যা।

distinctUsersCount

string ( int64 format)

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটি পরিদর্শনকারী স্বতন্ত্র ব্যবহারকারীর সংখ্যা।

distinctBrowsersCount

string ( int64 format)

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটি পরিদর্শনকারী স্বতন্ত্র ব্রাউজারের সংখ্যা।

contentTransferDetails

object ( ContentTransferDetails )

শুধুমাত্র আউটপুট। উপলব্ধ থাকলে, কন্টেন্ট স্থানান্তর ইভেন্ট সম্পর্কিত তথ্য প্রদান করে।

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" ।

বিষয়বস্তু স্থানান্তরের বিবরণ

বিষয়বস্তু স্থানান্তর ইভেন্ট সম্পর্কিত তথ্য প্রদান করে, যদি তা উপলব্ধ থাকে।

JSON উপস্থাপনা 
{
  "contentTransferCount": string
}
ক্ষেত্র
contentTransferCount

string ( int64 format)

শুধুমাত্র আউটপুট। অ্যাপ্লিকেশনটির সাথে সংশ্লিষ্ট মোট কন্টেন্ট স্থানান্তরের সংখ্যা।