রিপোর্ট টাস্ক মৌলিক

রিপোর্ট টাস্ক ব্যবহার করে, আপনি আপনার গুগল অ্যানালিটিক্স ইভেন্ট ডেটার একটি কাস্টমাইজড রিপোর্ট তৈরি করতে একটি দীর্ঘমেয়াদী অ্যাসিঙ্ক্রোনাস রিকোয়েস্ট শুরু করতে পারেন।

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

একটি কাস্টমাইজড রিপোর্ট প্রস্তুত হওয়ার পর ৭২ ঘণ্টার জন্য উপলব্ধ থাকবে। এই সময়কাল শেষে, সংশ্লিষ্ট রিপোর্ট টাস্ক রিসোর্স এবং এর বিষয়বস্তু স্বয়ংক্রিয়ভাবে মুছে যাবে।

একটি রিপোর্ট টাস্ক তৈরি করুন

গুগল অ্যানালিটিক্স ডেটা এপিআই v1 রিপোর্ট টাস্ক তৈরি করতে একটি অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করে। প্রথমে, একটি রিপোর্ট টাস্ক তৈরি করার জন্য reportTasks.create মেথডে একটি রিকোয়েস্ট পাঠানো প্রয়োজন। এরপর, তৈরি হওয়া কাস্টমাইজড রিপোর্টটি পুনরুদ্ধার করার জন্য reportTasks.query মেথডটি ব্যবহৃত হয়।

এছাড়াও, আপনি একটি নির্দিষ্ট রিপোর্ট টাস্কের কনফিগারেশন মেটাডেটা পুনরুদ্ধার করতে reportTasks.get এবং একটি প্রপার্টির অন্তর্গত সমস্ত রিপোর্ট টাস্কের তালিকা দেখতে reportTasks.list ব্যবহার করতে পারেন।

একটি রিপোর্টিং সত্তা নির্বাচন করুন

Data API v1-এর সমস্ত পদ্ধতির জন্য একটি URL অনুরোধ পাথের মধ্যে Google Analytics প্রপার্টি আইডেন্টিফায়ারটি properties/GA_PROPERTY_ID আকারে উল্লেখ করতে হয়, যেমন:

  POST  https://analyticsdata.googleapis.com/v1alpha/properties/GA_PROPERTY_ID/reportTasks

নির্দিষ্ট গুগল অ্যানালিটিক্স প্রপার্টিতে সংগৃহীত গুগল অ্যানালিটিক্স ইভেন্ট ডেটার উপর ভিত্তি করে রিপোর্টটি তৈরি করা হয়।

আপনি যদি ডেটা এপিআই ক্লায়েন্ট লাইব্রেরিগুলোর কোনো একটি ব্যবহার করেন, তাহলে রিকোয়েস্ট ইউআরএল পাথ ম্যানুয়ালি পরিবর্তন করার কোনো প্রয়োজন নেই। বেশিরভাগ এপিআই ক্লায়েন্ট একটি property প্যারামিটার প্রদান করে, যা properties/GA_PROPERTY_ID ফর্ম্যাটে একটি স্ট্রিং গ্রহণ করে। ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহারের উদাহরণের জন্য কুইক স্টার্ট গাইড দেখুন।

রিপোর্ট টাস্ক তৈরির অনুরোধ করুন

একটি রিপোর্ট টাস্ক তৈরি করতে, রিকোয়েস্টে ReportTask অবজেক্টটি ব্যবহার করে reportTasks.create মেথডটি কল করুন। নিম্নলিখিত প্যারামিটারগুলো আবশ্যক:

  • reportDefinition ফিল্ড, যা একটি কাস্টমাইজড রিপোর্টের সংজ্ঞা বর্ণনা করে। এই প্যারামিটারের গঠনটি কোর রিপোর্টিং পদ্ধতি দ্বারা ব্যবহৃত রিপোর্ট সংজ্ঞার অনুরূপ।

রিপোর্ট টাস্ক তৈরির অনুরোধের উদাহরণ:

HTTP অনুরোধ 

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/reportTasks
{
  "reportDefinition": {
    "dateRanges": [{ "startDate": "2024-05-01"", "endDate": "2024-05-15" }],
    "dimensions": [{ "name": "country" }],
    "metrics": [{ "name": "activeUsers" }]
  }
}

reportTasks.create মেথডের রেসপন্সের name ফিল্ডে রিপোর্ট টাস্কের নামটি থাকে (যেমন properties/1234567/reportTasks/123 ), যা পরবর্তী কোয়েরিগুলোতে কোনো রিপোর্ট টাস্কের স্ট্যাটাস জানতে এবং ফলাফলস্বরূপ রিপোর্টটি পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে।

HTTP প্রতিক্রিয়া 

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.ReportTask",
    "name": "properties/1234567/reportTasks/123",
    "reportDefinition": {
      "dimensions": [
        {
          "name": "country"
        }
      ],
      "metrics": [
        {
          "name": "activeUsers"
        }
      ],
      "dateRanges": [
        {
          "startDate": "2024-05-01",
          "endDate": "2024-05-15"
        }
      ]
    },
    "reportMetadata": {
      "state": "CREATING",
      "beginCreatingTime": "2024-05-16T00:00:01.133612336Z"
    }
  }
}

রিপোর্ট টাস্কের প্রস্তুতির অবস্থা জানুন

reportTasks.create কল করার পর একটি রিপোর্ট তৈরি হতে কয়েক মিনিট সময় লাগতে পারে। আপনি reportTasks.get মেথডটি কল করে একটি রিপোর্ট টাস্কের প্রস্তুতির অবস্থা জানতে পারেন।

রিপোর্ট টাস্কটি নির্দিষ্ট করার জন্য, reportTasks.create রেসপন্স থেকে পাওয়া রিপোর্ট টাস্কের নামটি (যেমন properties/1234567/reportTasks/123 ) ব্যবহার করুন।

উদাহরণ:

HTTP অনুরোধ 

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/reportTasks/123

একটি রিপোর্ট টাস্কের প্রস্তুতির অবস্থা রেসপন্সের state ফিল্ডে দেখানো হয়। রিপোর্ট তৈরি সম্পন্ন হলে, রিপোর্ট টাস্কের স্টেট CREATING থেকে ACTIVE এ পরিবর্তিত হয়।

reportMetadata ফিল্ডটিতে তৈরি হওয়া রিপোর্ট সম্পর্কিত উচ্চ-স্তরের তথ্য থাকে, যেমন সারির সংখ্যা এবং ব্যবহৃত কোটা টোকেনের পরিমাণ।

HTTP প্রতিক্রিয়া 

{
  "reportDefinition": {
    "dimensions": [
      {
        "name": "country"
      }
    ],
    "metrics": [
      {
        "name": "activeUsers"
      }
    ],
    "dateRanges": [
      {
        "startDate": "2024-05-01",
        "endDate": "2024-05-15"
      }
    ]
  },
  "reportMetadata": {
    "state": "ACTIVE",
    "beginCreatingTime": "2024-05-16T00:00:01.133612336Z",
    "creationQuotaTokensCharged": 6,
    "taskRowCount": 167,
    "errorMessage": "",
    "totalRowCount": 167
  }
}

আপনি reportTasks.list মেথডটি কল করে সমস্ত রিপোর্ট টাস্কের অবস্থা জানতে পারবেন।

তৈরি করা প্রতিবেদনটি পুনরুদ্ধার করুন।

reportTasks.create মেথড ব্যবহার করে রিপোর্ট টাস্কটি তৈরি হয়ে গেলে, reportTasks.query মেথডটি কল করুন এবং রিপোর্ট টাস্কের নামটি উল্লেখ করুন (যেমন properties/1234567/reportTasks/123 )।

HTTP অনুরোধ 

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/reportTasks/123:query

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

HTTP প্রতিক্রিয়া 

{
  "dimensionHeaders": [
    {
      "name": "country"
    }
  ],
  "metricHeaders": [
    {
      "name": "activeUsers",
      "type": "TYPE_INTEGER"
    }
  ],
  "rows": [

...

  ],
  "rowCount": 167,
  "metadata": {
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles"
  }
}