Method: domains.domainStats.query

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

HTTP অনুরোধ

POST https://gmailpostmastertools.googleapis.com/v2beta/{parent=domains/*}/domainStats:query

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

পথের পরামিতি

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

string

আবশ্যক। মূল রিসোর্সের নাম যেখান থেকে পরিসংখ্যান কোয়েরি করা হবে। ফরম্যাট: domains/{domain}

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

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "metricDefinitions": [
    {
      object (MetricDefinition)
    }
  ],
  "timeQuery": {
    object (TimeQuery)
  },
  "pageSize": integer,
  "pageToken": string,
  "aggregationGranularity": enum (AggregationGranularity)
}
ক্ষেত্র
metricDefinitions[]

object ( MetricDefinition )

আবশ্যক। যে নির্দিষ্ট মেট্রিকগুলো সম্পর্কে জানতে চান। আপনি প্রতিটি মেট্রিকের জন্য একটি নিজস্ব নাম নির্ধারণ করতে পারেন, যা রেসপন্সে ব্যবহৃত হবে।

timeQuery

object ( TimeQuery )

আবশ্যক। যে সময়সীমা বা নির্দিষ্ট তারিখগুলোর জন্য মেট্রিকগুলো সংগ্রহ করা হবে।

pageSize

integer

ঐচ্ছিক। রেসপন্সে ফেরত দেওয়ার জন্য DomainStats রিসোর্সের সর্বোচ্চ সংখ্যা। সার্ভার এই মানের চেয়ে কমও ফেরত দিতে পারে। নির্দিষ্ট না করা হলে, ডিফল্ট মান ১০ ব্যবহৃত হবে। সর্বোচ্চ মান হলো ২০০।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী কোনো তালিকা অনুরোধ থেকে প্রাপ্ত nextPageToken মান, যদি থাকে। যদি অ্যাগ্রিগেশন গ্র্যানুলারিটি DAILY হয়, তাহলে পেজ টোকেনটি হবে এনকোড করা তারিখ + "/" + মেট্রিকের নাম। যদি অ্যাগ্রিগেশন গ্র্যানুলারিটি OVERALL হয়, তাহলে পেজ টোকেনটি হবে এনকোড করা মেট্রিকের নাম।

aggregationGranularity

enum ( AggregationGranularity )

ঐচ্ছিক। পরিসংখ্যান একত্রিত করার সূক্ষ্মতা। অনির্দিষ্ট থাকলে, ডিফল্টরূপে দৈনিক (DAILY) হবে।

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

সফল হলে, রেসপন্স বডিতে QueryDomainStatsResponse এর একটি ইনস্ট্যান্স থাকে।

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

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/postmaster
  • https://www.googleapis.com/auth/postmaster.traffic.readonly

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