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 রিসোর্সের সর্বোচ্চ সংখ্যা। সার্ভার এই মানের চেয়ে কমও ফেরত দিতে পারে। নির্দিষ্ট না করা হলে, ডিফল্ট মান ১০ ব্যবহৃত হবে। সর্বোচ্চ মান হলো ২০০।

pageToken

string

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

aggregationGranularity

enum ( AggregationGranularity )

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

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

একটি ব্যাচের মধ্যে থাকা একটিমাত্র QueryDomainStatsRequest-এর ফলাফলকে বোঝায়।

JSON উপস্থাপনা 
{

  "response": {
    object (QueryDomainStatsResponse)
  },
  "error": {
    object (Status)
  }
}
ক্ষেত্র
ইউনিয়ন ফিল্ডের result । এটি স্বতন্ত্র কোয়েরির ফলাফল। result নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
response

object ( QueryDomainStatsResponse )

স্বতন্ত্র জিজ্ঞাসাটির সফল উত্তর।

error

object ( Status )

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

অবস্থা

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

এই এরর মডেল এবং এটি নিয়ে কীভাবে কাজ করতে হয়, সে সম্পর্কে আরও জানতে আপনি এপিআই ডিজাইন গাইড দেখতে পারেন।

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

integer

স্ট্যাটাস কোডটি google.rpc.Code এর একটি enum ভ্যালু হওয়া উচিত।

message

string

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

details[]

object

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