টাস্ক সংক্রান্ত অভিযোগের প্রাথমিক বিষয়

রিপোর্ট টাস্ক ব্যবহার করে, আপনি Google Analytics ইভেন্ট ডেটার কাস্টমাইজ করা রিপোর্ট তৈরি করতে দীর্ঘক্ষণ ধরে চলতে থাকা অ্যাসিঙ্ক্রোনাস অনুরোধ শুরু করতে পারবেন।

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

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

রিপোর্ট টাস্ক তৈরি করা

Google Analytics Data API v1, রিপোর্ট টাস্ক তৈরি করার জন্য অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করে। প্রথমে, রিপোর্ট টাস্ক তৈরি করার জন্য reportTasks.create মেথডের অনুরোধ করা প্রয়োজন। তারপরে, জেনারেট করা কাস্টমাইজড রিপোর্ট পেতে reportTasks.query পদ্ধতি ব্যবহার করা হয়।

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

অভিযোগ জানানোর এন্টিটি বেছে নিন

Data API v1-এর সব পদ্ধতিতে Google Analytics প্রপার্টি শনাক্তকারী URL অনুরোধ পাথের মধ্যে properties/GA_PROPERTY_ID-এর মতো ফর্ম্যাটে নির্দিষ্ট করতে হয়, যেমন:

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

নির্দিষ্ট Google Analytics প্রপার্টিতে সংগ্রহ করা Google Analytics ইভেন্ট ডেটার উপর ভিত্তি করে রিপোর্ট তৈরি করা হয়।

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

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

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

  • reportDefinition কাস্টমাইজ করা রিপোর্টের সংজ্ঞা বর্ণনা করে এমন ফিল্ড। এই প্যারামিটারের স্ট্রাকচার Core Reporting পদ্ধতির ব্যবহার করা রিপোর্ট ডেফিনিশনের মতো।

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

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 ফিল্ডে Report Task 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 মেথড কল করে কোনও রিপোর্ট টাস্কের রেডি স্টেট পেতে পারেন।

অভিযোগ জানানোর টাস্কের নাম (যেমন properties/1234567/reportTasks/123) ব্যবহার করুন যা আপনি reportTasks.create উত্তর থেকে পেয়েছেন অভিযোগ জানানোর টাস্ক নির্দিষ্ট করতে।

উদাহরণ:

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"
  }
}