Method: domainStats.batchQuery

একাধিক ডোমেনের জন্য QueryDomainStats অনুরোধের একটি ব্যাচ কার্যকর করে। যদি আপনার অনুরোধ করা কোনও ডোমেনের জন্য DomainStats অ্যাক্সেস করার অনুমতি না থাকে তবে PERMISSION_DENIED ফেরত দেয়।

HTTP অনুরোধ

POST https://gmailpostmastertools.googleapis.com/v2beta/domainStats:batchQuery

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

অনুরোধের মূল অংশ

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

JSON উপস্থাপনা 
{
  "requests": [
    {
      object (QueryDomainStatsRequest)
    }
  ]
}
ক্ষেত্র
requests[]

object ( QueryDomainStatsRequest )

প্রয়োজন। পৃথক কোয়েরি অনুরোধের একটি তালিকা। প্রতিটি অনুরোধ ভিন্ন ডোমেনের জন্য হতে পারে। একটি ব্যাচে সর্বাধিক ১০০টি অনুরোধ অন্তর্ভুক্ত করা যেতে পারে।

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

domainStats.batchQuery-এর জন্য প্রতিক্রিয়া বার্তা।

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

JSON উপস্থাপনা 
{
  "results": [
    {
      object (BatchQueryDomainStatsResult)
    }
  ]
}
ক্ষেত্র
results[]

object ( BatchQueryDomainStatsResult )

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

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

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

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

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

কোয়েরিডোমেইনস্ট্যাটসরিকোয়েস্ট

QueryDomainStats-এর জন্য অনুরোধ বার্তা।

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

string

প্রয়োজনীয়। মূল রিসোর্সের নাম যেখানে পরিসংখ্যান জিজ্ঞাসা করা হয়। ফর্ম্যাট: domains/{domain}

metricDefinitions[]

object ( MetricDefinition )

প্রয়োজনীয়। কোয়েরির জন্য নির্দিষ্ট মেট্রিক্স। আপনি প্রতিটি মেট্রিকের জন্য একটি কাস্টম নাম নির্ধারণ করতে পারেন, যা প্রতিক্রিয়ায় ব্যবহৃত হবে।

timeQuery

object ( TimeQuery )

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

pageSize

integer

ঐচ্ছিক। প্রতিক্রিয়ায় সর্বাধিক কত সংখ্যক DomainStats রিসোর্স ফেরত পাঠানো হবে। সার্ভার এই মানের চেয়ে কম রিটার্ন করতে পারে। যদি নির্দিষ্ট না করা থাকে, তাহলে 10 এর একটি ডিফল্ট মান ব্যবহার করা হবে। সর্বোচ্চ মান হল 200।

pageToken

string

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

aggregationGranularity

enum ( AggregationGranularity )

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

ব্যাচকুয়েরিডোমেইনস্ট্যাটসফলাফল

একটি ব্যাচের মধ্যে একটি একক QueryDomainStatsRequest এর ফলাফল উপস্থাপন করে।

JSON উপস্থাপনা 
{

  // Union field result can be only one of the following:
  "response": {
    object (QueryDomainStatsResponse)
  },
  "error": {
    object (Status)
  }
  // End of list of possible types for union field result.
}
ক্ষেত্র
Union ক্ষেত্রের result । পৃথক প্রশ্নের ফলাফল। result নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
response

object ( QueryDomainStatsResponse )

পৃথক প্রশ্নের সফল উত্তর।

error

object ( Status )

পৃথক কোয়েরি ব্যর্থ হলে ত্রুটির অবস্থা।

অবস্থা

Status টাইপ একটি লজিক্যাল এরর মডেলকে সংজ্ঞায়িত করে যা REST API এবং RPC API সহ বিভিন্ন প্রোগ্রামিং পরিবেশের জন্য উপযুক্ত। এটি gRPC দ্বারা ব্যবহৃত হয়। প্রতিটি Status বার্তায় তিনটি ডেটা থাকে: ত্রুটি কোড, ত্রুটি বার্তা এবং ত্রুটির বিবরণ।

এই ত্রুটি মডেল এবং এটির সাথে কীভাবে কাজ করবেন সে সম্পর্কে আপনি API ডিজাইন গাইডে আরও জানতে পারবেন।

JSON উপস্থাপনা 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
ক্ষেত্র
code

integer

স্ট্যাটাস কোড, যা google.rpc.Code এর একটি enum মান হওয়া উচিত।

message

string

ডেভেলপার-মুখোমুখি ত্রুটির বার্তা, যা ইংরেজিতে হওয়া উচিত। ব্যবহারকারী-মুখোমুখি যেকোনো ত্রুটির বার্তা স্থানীয়করণ করে google.rpc.Status.details ক্ষেত্রে পাঠানো উচিত, অথবা ক্লায়েন্ট দ্বারা স্থানীয়করণ করা উচিত।

details[]

object

ত্রুটির বিবরণ বহনকারী বার্তাগুলির একটি তালিকা। API গুলির ব্যবহারের জন্য বার্তার ধরণের একটি সাধারণ সেট রয়েছে।