Method: properties.reportTasks.query

একটি রিপোর্ট টাস্কের বিষয়বস্তু পুনরুদ্ধার করে। reportTasks.create অনুরোধ করার পর, রিপোর্টটি ACTIVE হলে আপনি এর বিষয়বস্তু পুনরুদ্ধার করতে পারবেন। রিপোর্ট টাস্কের অবস্থা ACTIVE না হলে এই মেথডটি একটি এরর রিটার্ন করবে। একটি কোয়েরি রেসপন্স রিপোর্টের টেবুলার সারি ও কলামের মানগুলো ফেরত দেবে।

HTTP অনুরোধ

POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query

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

পথের পরামিতি

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

string

আবশ্যক। রিপোর্টের উৎসের নাম। ফরম্যাট: properties/{property}/reportTasks/{report}

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

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

JSON উপস্থাপনা
{
  "offset": string,
  "limit": string
}
ক্ষেত্র
offset

string ( int64 format)

ঐচ্ছিক। রিপোর্টের শুরুর সারির সংখ্যা। প্রথম সারিকে সারি ০ হিসাবে গণনা করা হয়।

পেজিং করার সময়, প্রথম অনুরোধে অফসেট নির্দিষ্ট করা হয় না; অথবা সমতুল্যভাবে, অফসেটকে ০-তে সেট করা হয়; সেক্ষেত্রে প্রথম অনুরোধটি সারির প্রথম limit পর্যন্ত ফেরত দেয়। দ্বিতীয় অনুরোধে অফসেটকে প্রথম অনুরোধের limit সমান সেট করা হয়; সেক্ষেত্রে দ্বিতীয় অনুরোধটি সারির দ্বিতীয় limit ফেরত দেয়।

এই পেজিনেশন প্যারামিটার সম্পর্কে আরও জানতে, পেজিনেশন দেখুন।

limit

string ( int64 format)

ঐচ্ছিক। রিপোর্ট থেকে ফেরত আসা সারির সংখ্যা। নির্দিষ্ট না করা হলে, ১০,০০০টি সারি ফেরত দেওয়া হয়। আপনি যতগুলোই অনুরোধ করুন না কেন, এপিআই প্রতি অনুরোধে সর্বোচ্চ ২,৫০,০০০টি সারি ফেরত দেয়। limit অবশ্যই ধনাত্মক হতে হবে।

যদি limit সমান সংখ্যক ডাইমেনশন ভ্যালু না থাকে, তাহলে এপিআই অনুরোধ করা limit চেয়ে কম সারিও ফেরত দিতে পারে। একটি QueryReportTaskRequest-এর জন্য উপলব্ধ সারির সংখ্যা সংশ্লিষ্ট ReportTask-এর লিমিট দ্বারা আরও সীমিত থাকে। একটি কোয়েরি সর্বাধিক ReportTask.limit সংখ্যক সারি পুনরুদ্ধার করতে পারে। উদাহরণস্বরূপ, যদি ReportTask-এর লিমিট ১,০০০ হয়, তাহলে offset=900 এবং limit=500 সহ একটি reportTasks.query অনুরোধ সর্বাধিক ১০০টি সারি ফেরত দেবে।

এই পেজিনেশন প্যারামিটার সম্পর্কে আরও জানতে, পেজিনেশন দেখুন।

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

একটি রিপোর্ট টাস্কের সাথে সম্পর্কিত রিপোর্টের বিষয়বস্তু।

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

JSON উপস্থাপনা
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "metadata": {
    object (ResponseMetaData)
  }
}
ক্ষেত্র
dimensionHeaders[]

object ( DimensionHeader )

ডাইমেনশন কলামগুলোর বর্ণনা দেয়। ডাইমেনশনহেডারের সংখ্যা এবং ক্রমবিন্যাস সারিগুলোতে উপস্থিত ডাইমেনশনগুলোর সাথে মিলে যায়।

metricHeaders[]

object ( MetricHeader )

মেট্রিক কলামগুলোর বর্ণনা দেয়। মেট্রিকহেডারগুলোর সংখ্যা এবং ক্রমবিন্যাস সারিগুলোতে উপস্থিত মেট্রিকগুলোর সাথে মিলে যায়।

rows[]

object ( Row )

রিপোর্টে থাকা ডাইমেনশন ভ্যালু কম্বিনেশন এবং মেট্রিক ভ্যালুগুলোর সারি।

totals[]

object ( Row )

অনুরোধ করা হলে, মেট্রিকগুলোর মোট মান।

maximums[]

object ( Row )

অনুরোধ করা হলে, মেট্রিকগুলোর সর্বোচ্চ মান।

minimums[]

object ( Row )

অনুরোধ করা হলে, মেট্রিকগুলোর সর্বনিম্ন মান।

rowCount

integer

কোয়েরির ফলাফলে থাকা মোট সারির সংখ্যা।

metadata

object ( ResponseMetaData )

রিপোর্টটির মেটাডেটা।

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

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics