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

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

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

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

দ্রষ্টব্য: প্রতিবেদনের কার্যগুলি ডেটা API-এর v1alpha সংস্করণে উপলব্ধ৷

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

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

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

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

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

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

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

আপনি যদি ডেটা API ক্লায়েন্ট লাইব্রেরিগুলির মধ্যে একটি ব্যবহার করেন তবে অনুরোধ URL পাথটি ম্যানুয়ালি ম্যানিপুলেট করার দরকার নেই৷ বেশিরভাগ API ক্লায়েন্ট একটি 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 পদ্ধতিতে কল করে রিপোর্ট টাস্কের জন্য প্রস্তুতির অবস্থা পেতে পারেন।

রিপোর্ট টাস্ক নির্দিষ্ট করার জন্য রিপোর্ট টাস্ক নামটি ব্যবহার করুন (যেমন 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"
  }
}