Method: domains.domainStats.query

একটি নির্দিষ্ট ডোমেন এবং সময়কালের জন্য ডোমেন পরিসংখ্যানের একটি তালিকা পুনরুদ্ধার করে। যদি আপনার ডোমেনের জন্য ডোমেনস্ট্যাট অ্যাক্সেস করার অনুমতি না থাকে তবে 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 রিসোর্স ফেরত পাঠানো হবে। সার্ভার এই মানের চেয়ে কম রিটার্ন করতে পারে। যদি নির্দিষ্ট না করা থাকে, তাহলে 10 এর একটি ডিফল্ট মান ব্যবহার করা হবে। সর্বোচ্চ মান হল 200।

pageToken

string

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

aggregationGranularity

enum ( AggregationGranularity )

ঐচ্ছিক। পরিসংখ্যান একত্রিত করার জন্য গ্র্যানুলারিটি কত। যদি নির্দিষ্ট না করা থাকে, তাহলে ডিফল্টভাবে DAILY হবে।

প্রতিক্রিয়া মূল অংশ

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

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

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

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

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