Google Service Account کی سیٹ اپ
Google service account بنائیں، Search Console اور Analytics APIs فعال کریں، اور JSON key کو 1MarketingTool سے جوڑیں۔
Google service account کا استعمال کریں جب آپ چاہتے ہیں کہ 1MarketingTool ذاتی Google اکاؤنٹ سے سائن ان کیے بغیر Search Console اور GA4 ڈیٹا پڑھے۔
فوری Cloud Shell فلو منتخب کریں، یا دستی Google Cloud Console کا طریقہ اپنائیں۔
Cloud Shell سے فوری سیٹ اپ
Cloud Shell براؤزر میں چلتا ہے، پہلے سے آپ کے Google اکاؤنٹ سے سائن ان ہوتا ہے۔ Cloud Shell کھولیں، اسکرپٹ پیسٹ کریں، Enter دبائیں، اور مکمل ہونے پر key.json ڈاؤن لوڈ ہو جاتی ہے۔ پھر ڈاؤن لوڈ کی گئی key لوڈ کرنے کے لیے 1MarketingTool میں Import JSON استعمال کریں اور اسے محفوظ کریں۔
set -e
PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
if [ -z "$PROJECT_ID" ]; then
PROJECT_ID="marketing-tool-$RANDOM$RANDOM"
gcloud projects create "$PROJECT_ID" --set-as-default
fi
gcloud services enable iam.googleapis.com searchconsole.googleapis.com analyticsadmin.googleapis.com \
analyticsdata.googleapis.com indexing.googleapis.com --project "$PROJECT_ID"
SA_EMAIL="marketing-tool@$PROJECT_ID.iam.gserviceaccount.com"
gcloud iam service-accounts create marketing-tool --display-name "1MarketingTool" --project "$PROJECT_ID" || true
echo "Waiting for the service account to be ready..."
for i in $(seq 1 30); do
gcloud iam service-accounts describe "$SA_EMAIL" --project "$PROJECT_ID" >/dev/null 2>&1 && break
sleep 2
done
rm -f key.json
gcloud iam service-accounts keys create key.json --iam-account "$SA_EMAIL" --project "$PROJECT_ID"
cloudshell download key.json
echo "Grant read access in Search Console and GA4 to: $SA_EMAIL"1. Google Cloud Project بنائیں
Google Cloud Console کھولیں، اوپر بار میں پروجیکٹ ڈراپ ڈاؤن استعمال کریں، پھر New Project منتخب کریں۔ اگر آپ کے پاس پہلے سے اس ورک اسپیس کے لیے کوئی پروجیکٹ ہے تو آپ اسے دوبارہ استعمال کر سکتے ہیں۔
پروجیکٹ کو ایک قابل شناخت نام دیں، جیسے marketing-tool، پھر Create پر کلک کریں۔
آگے بڑھنے سے پہلے یقینی بنائیں کہ نیا پروجیکٹ اوپر بار میں منتخب ہے۔
2. Service Account بنائیں
APIs & Services -> Credentials پر جائیں، پھر Create credentials -> Service account منتخب کریں۔
ایک نام درج کریں جیسے marketing-tool-reader۔ Google اس نام سے service account ID اور ای میل ایڈریس خود بنائے گا۔ Create and continue پر کلک کریں۔
آپ Google Cloud پروجیکٹ رول دینا چھوڑ سکتے ہیں۔ Search Console اور GA4 تک رسائی بعد میں ان مصنوعات کے اندر دی جاتی ہے۔ Done پر کلک کریں۔
Service account ای میل کاپی کریں۔ یہ کچھ ایسی دکھتی ہے [email protected]۔ آپ یہ ای میل Search Console اور Analytics تک رسائی دیتے وقت استعمال کریں گے۔
3. JSON Key ڈاؤن لوڈ کریں
Service account کھولیں، Keys ٹیب پر جائیں، پھر Add key -> Create new key منتخب کریں۔
JSON منتخب کریں، پھر Create پر کلک کریں۔ ایک .json فائل آپ کے کمپیوٹر پر ڈاؤن لوڈ ہوگی۔ اس فائل کو نجی رکھیں کیونکہ یہ ایک credential ہے۔
4. ضروری APIs فعال کریں
Google Cloud Console میں، APIs & Services -> Library کھولیں اور Google Search Console API تلاش کریں۔
Google Search Console API منتخب کریں۔
منتخب پروجیکٹ کے لیے Enable پر کلک کریں۔
API Library پر واپس جائیں، Google Analytics Data API تلاش کریں، پھر اسے فعال کریں۔ یہ API GA4 رپورٹنگ کے لیے ضروری ہے۔
اختیاری طور پر Google Analytics Admin API بھی فعال کریں۔ اس سے ایپ GA4 properties کی فہرست دکھا سکتی ہے جب منسلک ورک فلو اس کی حمایت کرے۔
5. Search Console میں رسائی دیں
Google Search Console کھولیں، وہ property منتخب کریں جسے آپ جوڑنا چاہتے ہیں، پھر Settings -> Users and permissions -> Add user پر جائیں۔
مرحلہ 2 سے service account ای میل پیسٹ کریں۔ Full یا Restricted اجازت منتخب کریں، پھر Add پر کلک کریں۔
6. Google Analytics میں رسائی دیں
Google Analytics کھولیں، Admin پر کلک کریں، پھر صحیح GA4 property منتخب کریں۔
Property access management پر جائیں، + پر کلک کریں، اور service account ای میل شامل کریں۔ Viewer یا Analyst رسائی استعمال کریں، پھر Add پر کلک کریں۔
7. 1MarketingTool میں جوڑیں
1MarketingTool میں، Google provider یا integration settings کھولیں اور پہلے ڈاؤن لوڈ کی گئی JSON key فائل امپورٹ کریں۔
محفوظ کرنے کے بعد، Search Console یا GA4 property کو ایپ میں صحیح پروجیکٹ سے میپ کریں۔
نوٹس
- اگر Search Console یا GA4 ڈیٹا فوراً ظاہر نہ ہو، تھوڑا انتظار کریں اور دوبارہ کوشش کریں۔ Google اجازتوں کو پھیلنے میں چند منٹ لگ سکتے ہیں۔
- ایک service account کو جتنی چاہیں Search Console اور GA4 properties میں شامل کیا جا سکتا ہے، پھر 1MarketingTool میں فی پروجیکٹ میپ کیا جا سکتا ہے۔
- اگر آپ Google Cloud میں JSON key گھماتے یا حذف کرتے ہیں، تو ایپ میں نئی key امپورٹ کریں۔
- JSON key کو محفوظ طریقے سے ذخیرہ کریں اور اسے سورس کنٹرول میں جمع نہ کرائیں۔