Method: entityUsageReports.get

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

HTTP অনুরোধ

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

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

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

পরামিতি
entityType

enum ( EntityType )

প্রতিবেদনের জন্য সত্তার ধরন উপস্থাপন করে।

entityKey or all

string

ডেটা ফিল্টার করার জন্য বস্তুর কী প্রতিনিধিত্ব করে। এটি এমন একটি স্ট্রিং যা all ব্যবহারকারীর জন্য কার্যকলাপ ইভেন্ট পেতে বা একটি অ্যাপ-নির্দিষ্ট সত্তার জন্য অন্য কোনো মান পেতে পারে। একটি নির্দিষ্ট entityType জন্য entityKey কীভাবে পেতে হয় তার বিশদ বিবরণের জন্য, সত্তা ব্যবহারের পরামিতি রেফারেন্স নির্দেশিকা দেখুন।

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/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0

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

  • == - 'সমান'।
  • <> - 'সমান নয়'। এটি ইউআরএল-এনকোডেড (%3C%3E)।
  • < - 'এর চেয়ে কম'। এটি URL-এনকোডেড (%3C)।
  • <= - 'এর চেয়ে কম বা সমান'। এটি URL-এনকোডেড (%3C=)।
  • > - 'এর চেয়ে বড়'। এটি URL-এনকোডেড (%3E)।
  • >= - 'এর চেয়ে বড় বা সমান'। এটি URL-এনকোডেড (%3E=)।
ফিল্টার শুধুমাত্র সাংখ্যিক পরামিতি প্রয়োগ করা যেতে পারে.

maxResults

integer ( uint32 format)

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

pageToken

string

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

parameters

string

parameters ক্যোয়ারী স্ট্রিং হল ইভেন্ট প্যারামিটারের একটি কমা-বিভক্ত তালিকা যা রিপোর্টের ফলাফলগুলিকে পরিমার্জিত করে। পরামিতি একটি নির্দিষ্ট অ্যাপ্লিকেশনের সাথে যুক্ত। সত্তা ব্যবহারের প্রতিবেদনের জন্য আবেদনের মানগুলি শুধুমাত্র gplus ।
একটি parameter ক্যোয়ারী স্ট্রিং [app_name1:param_name1], [app_name2:param_name2]... এর CSV আকারে রয়েছে।

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

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

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

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

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

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

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

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

সত্তা টাইপ

এনামস
gplus_communities Google+ সম্প্রদায়গুলির উপর একটি প্রতিবেদন প্রদান করে৷