Method: properties.reportTasks.query

রিপোর্ট টাস্কের বিষয়বস্তু পুনরুদ্ধার করে। reportTasks.create অনুরোধ করার পর, রিপোর্টটি সক্রিয় হয়ে গেলে আপনি রিপোর্টের বিষয়বস্তু পুনরুদ্ধার করতে পারবেন। রিপোর্ট টাস্কের অবস্থা 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)

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

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

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

limit

string ( int64 format)

ঐচ্ছিক। রিপোর্ট থেকে যে সারিতে ফিরতে হবে। অনির্দিষ্ট থাকলে, 10,000 সারি ফেরত দেওয়া হয়। এপিআই প্রতি অনুরোধে সর্বাধিক 250,000 সারি প্রদান করে, আপনি যতই জিজ্ঞাসা করুন না কেন। limit ইতিবাচক হতে হবে।

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

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

প্রতিক্রিয়া শরীর

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

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

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

প্রতিক্রিয়া মেটাডেটা

প্রতিক্রিয়ার মেটাডেটা রিপোর্টের বিষয়বস্তু সম্পর্কে অতিরিক্ত তথ্য বহন করে।

JSON প্রতিনিধিত্ব
{
  "dataLossFromOtherRow": boolean,
  "schemaRestrictionResponse": {
    object (SchemaRestrictionResponse)
  },
  "currencyCode": string,
  "timeZone": string,
  "emptyReason": string,
  "subjectToThresholding": boolean
}
ক্ষেত্র
dataLossFromOtherRow

boolean

যদি সত্য হয়, নির্দেশ করে যে মাত্রার সংমিশ্রণের কিছু বালতি "(অন্যান্য)" সারিতে রোল করা হয়েছে। এটি উচ্চ কার্ডিনালিটি রিপোর্টের জন্য ঘটতে পারে।

মেটাডেটা প্যারামিটার dataLossFromOtherRow রিপোর্টে ব্যবহৃত সমষ্টিগত ডেটা টেবিলের উপর ভিত্তি করে তৈরি করা হয়। রিপোর্টে ফিল্টার এবং সীমা নির্বিশেষে প্যারামিটারটি সঠিকভাবে পপুলেট করা হবে।

উদাহরণস্বরূপ, (অন্যান্য) সারিটি প্রতিবেদন থেকে বাদ দেওয়া যেতে পারে কারণ অনুরোধটিতে সেশনসোর্স = google এ একটি ফিল্টার রয়েছে৷ এই প্যারামিটারটি এখনও পপুলেট করা হবে যদি এই রিপোর্ট তৈরি করতে ব্যবহৃত ইনপুট সামগ্রিক ডেটাতে অন্য সারি থেকে ডেটা হারানো থাকে।

আরও জানতে, (অন্যান্য) সারি এবং ডেটা স্যাম্পলিং সম্পর্কে দেখুন।

schemaRestrictionResponse

object ( SchemaRestrictionResponse )

এই প্রতিবেদন তৈরিতে সক্রিয়ভাবে প্রয়োগ করা স্কিমা সীমাবদ্ধতাগুলি বর্ণনা করে৷ আরও জানতে, অ্যাক্সেস এবং ডেটা-সীমাবদ্ধতা ব্যবস্থাপনা দেখুন।

currencyCode

string

এই প্রতিবেদনে ব্যবহৃত মুদ্রা কোড. ভিজ্যুয়ালাইজেশনের জন্য purchaseRevenue মতো মুদ্রার মেট্রিক্স ফর্ম্যাটিংয়ে ব্যবহার করার উদ্দেশ্যে। যদি অনুরোধে কারেন্সিকোড নির্দিষ্ট করা থাকে, তাহলে এই প্রতিক্রিয়া প্যারামিটারটি অনুরোধের প্যারামিটারটিকে প্রতিধ্বনিত করবে; অন্যথায়, এই প্রতিক্রিয়া পরামিতি হল সম্পত্তির বর্তমান মুদ্রার কোড।

মুদ্রা কোড হল ISO 4217 স্ট্যান্ডার্ড ( https://en.wikipedia.org/wiki/ISO_4217) থেকে মুদ্রার প্রকারের স্ট্রিং এনকোডিং; যেমন "USD", "EUR", "JPY"। আরও জানতে, https://support.google.com/analytics/answer/9796179 দেখুন।

timeZone

string

সম্পত্তির বর্তমান টাইমজোন। hour এবং minute মতো সময়-ভিত্তিক মাত্রাগুলি ব্যাখ্যা করতে ব্যবহার করার উদ্দেশ্যে। IANA টাইম জোন ডাটাবেস থেকে স্ট্রিং হিসাবে ফর্ম্যাট করা হয়েছে ( https://www.iana.org/time-zones) ; যেমন "America/New_York" বা "Asia/Tokyo"।

emptyReason

string

খালি কারণ নির্দিষ্ট করা হলে, রিপোর্ট এই কারণে খালি হয়.

subjectToThresholding

boolean

subjectToThresholding সত্য হলে, এই প্রতিবেদনটি থ্রেশহোল্ডিং সাপেক্ষে এবং শুধুমাত্র সেই ডেটা ফেরত দেয় যা ন্যূনতম একত্রীকরণ থ্রেশহোল্ড পূরণ করে। থ্রেশহোল্ডিং থ্রেশহোল্ডিং সাপেক্ষে একটি অনুরোধের জন্য এটি সম্ভব এবং প্রতিবেদনে কোনও ডেটা অনুপস্থিত থাকে এবং এটি ঘটে যখন সমস্ত ডেটা থ্রেশহোল্ডের উপরে থাকে। আরও জানতে, ডেটা থ্রেশহোল্ড এবং ডেমোগ্রাফিক্স এবং আগ্রহগুলি দেখুন।

স্কিমা রেস্ট্রিকশন রেসপন্স

এই প্রতিবেদন তৈরিতে স্কিমা সীমাবদ্ধতা সক্রিয়ভাবে প্রয়োগ করা হয়েছে। আরও জানতে, অ্যাক্সেস এবং ডেটা-সীমাবদ্ধতা ব্যবস্থাপনা দেখুন।

JSON প্রতিনিধিত্ব
{
  "activeMetricRestrictions": [
    {
      object (ActiveMetricRestriction)
    }
  ]
}
ক্ষেত্র
activeMetricRestrictions[]

object ( ActiveMetricRestriction )

রিপোর্ট তৈরিতে সমস্ত বিধিনিষেধ সক্রিয়ভাবে প্রয়োগ করা হয়েছে। উদাহরণ স্বরূপ, purchaseRevenue সর্বদা REVENUE_DATA ধরনের সীমাবদ্ধতা থাকে। যাইহোক, এই সক্রিয় প্রতিক্রিয়া বিধিনিষেধ শুধুমাত্র তখনই তৈরি হয় যখন ব্যবহারকারীর কাস্টম ভূমিকা REVENUE_DATA তে অ্যাক্সেসের অনুমতি দেয় না।

অ্যাক্টিভমেট্রিক সীমাবদ্ধতা

রিপোর্ট তৈরিতে সক্রিয়ভাবে সীমাবদ্ধ একটি মেট্রিক।

JSON প্রতিনিধিত্ব
{
  "restrictedMetricTypes": [
    enum (RestrictedMetricType)
  ],
  "metricName": string
}
ক্ষেত্র
restrictedMetricTypes[]

enum ( RestrictedMetricType )

এই মেট্রিকের সীমাবদ্ধতার কারণ।

metricName

string

সীমাবদ্ধ মেট্রিকের নাম।

RestrictedMetricType

কিছু GA4 প্রপার্টি দেখতে আপনাকে সীমাবদ্ধ করা হতে পারে এমন ডেটার বিভাগ।

Enums
RESTRICTED_METRIC_TYPE_UNSPECIFIED অনির্দিষ্ট প্রকার।
COST_DATA খরচ মেট্রিক্স যেমন adCost ।
REVENUE_DATA রাজস্ব মেট্রিক্স যেমন purchaseRevenue ।