কমান্ড লাইন ব্যবহার করে API Quickstart

এই পৃষ্ঠাটি আপনাকে দেখায় কিভাবে কমান্ড লাইন ব্যবহার করে Google Analytics ডেটা API v1 দিয়ে শুরু করবেন।

ধাপ 1. API সক্ষম করুন

একটি নতুন ক্লাউড প্ল্যাটফর্ম প্রকল্প তৈরি করতে এই বোতামটি ক্লিক করুন, স্বয়ংক্রিয়ভাবে Google Analytics ডেটা API v1 সক্ষম করুন এবং এই টিউটোরিয়ালের জন্য প্রয়োজনীয় OAuth2 শংসাপত্র তৈরি করুন:

Google Analytics ডেটা API v1 সক্ষম করুন৷

আপনাকে স্বয়ংক্রিয়ভাবে OAuth2 শংসাপত্র কনফিগারেশন ডায়ালগে পুনঃনির্দেশিত করা হবে। "আপনি কোথা থেকে কল করছেন?" জিজ্ঞেস করলে "ডেস্কটপ" বেছে নিন

ফলস্বরূপ ডায়ালগে ক্লিক করুন ক্লায়েন্ট কনফিগারেশন ডাউনলোড করুন এবং ফাইল credentials.json আপনার কাজের ডিরেক্টরিতে সংরক্ষণ করুন।

বিকল্পভাবে, আপনি ম্যানুয়ালি একটি বিদ্যমান প্রকল্পে একটি OAuth2 শংসাপত্র তৈরি করতে এই পদক্ষেপগুলি অনুসরণ করতে পারেন৷

ধাপ 2. ক্লাউড SDK ইনস্টল করুন এবং আরম্ভ করুন

আপনার ডেভেলপমেন্ট মেশিনে gcloud কমান্ড লাইন টুল ইনস্টল করা প্রয়োজন।

ধাপ 3: একটি API কল করুন

এখন আপনি Google Analytics 4 প্রপার্টি অনুসন্ধান করতে Google Analytics ডেটা API ব্যবহার করতে পারেন।

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

এই টিউটোরিয়ালে, আমরা API অনুরোধে ব্যবহার করা সম্পত্তি আইডি সংরক্ষণ করতে পরিবেশ পরিবর্তনশীল GA4_PROPERTY_ID ব্যবহার করব।

GA4_PROPERTY_ID ভেরিয়েবল সেট করতে আপনার কমান্ড লাইনে নিম্নলিখিতটি লিখুন:

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

আপনার Google Analytics 4 প্রপার্টি আইডেন্টিফায়ার দিয়ে [YOUR-GA4-PROPERTY-ID] প্রতিস্থাপন করুন। উদাহরণ স্বরূপ:

export GA4_PROPERTY_ID=1234567890

অনুরোধ JSON তৈরি করুন

নিম্নলিখিত request.json ফাইলটি দেখায় কিভাবে একটি সাধারণ প্রতিবেদন তৈরি করতে হয়।

নিম্নলিখিত পাঠ্য সহ JSON অনুরোধ ফাইলটি তৈরি করুন এবং আপনার কার্যকারী ডিরেক্টরিতে একটি request.json প্লেইন টেক্সট ফাইল হিসাবে সংরক্ষণ করুন:

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

প্রমাণীকরণ

এই উদাহরণে ব্যবহারকারীর শংসাপত্রগুলি পেতে, নিম্নলিখিত কমান্ডটি চালান এবং ধাপ 1 এ ডাউনলোড করা শংসাপত্র JSON ফাইলের পথটি ব্যবহার করুন:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

একটি OAuth ব্যবহারকারীর সম্মতি ডায়ালগ একটি নতুন ব্রাউজার উইন্ডোতে খুলবে।

অনুরোধ পাঠান

Google Analytics ডেটা API-তে অনুরোধ পাঠাতে request.json থেকে curl এবং বডি কন্টেন্ট ব্যবহার করুন। আপনার কমান্ড লাইনে নিম্নলিখিত লিখুন:

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json

একটি প্রমাণীকরণ টোকেন পেতে curl কমান্ড gcloud auth application-default print-access-token কমান্ড ব্যবহার করে।

নোট করুন যে কার্ল করার জন্য একটি ফাইলের নাম পাস করতে আপনি -d বিকল্পটি ব্যবহার করুন ("ডেটা" এর জন্য) এবং একটি @ চিহ্ন সহ ফাইলের নামের আগে। এই ফাইলটি একই ডিরেক্টরিতে থাকা উচিত যেখানে আপনি কার্ল কমান্ডটি চালান।

অভিনন্দন! আপনি Google Analytics ডেটা API-তে আপনার প্রথম অনুরোধ পাঠিয়েছেন।