Method: projects.addGoogleAnalytics

ربط FirebaseProject المحدد بحساب Google Analytics موجود.

باستخدام هذه المكالمة، يمكنك إما:

  • حدد analyticsAccountId لتوفير موقع Google Analytics جديد ضمن الحساب المحدد وربط الموقع الجديد بـ FirebaseProject .
  • حدد analyticsPropertyId الموجود لربط الخاصية بـ FirebaseProject .

لاحظ أنه عند الاتصال projects.addGoogleAnalytics :

  1. يحدد الفحص الأول ما إذا كانت أي مصادر بيانات موجودة في موقع Google Analytics تتوافق مع أي تطبيقات Firebase موجودة في FirebaseProject (استنادًا إلى packageName أو bundleId المرتبط بمصدر البيانات). وبعد ذلك، حسب الاقتضاء، يتم ربط مصادر البيانات والتطبيقات. لاحظ أن هذا الارتباط التلقائي ينطبق فقط على AndroidApps و IosApps .
  2. إذا لم يتم العثور على مصادر بيانات مقابلة لتطبيقات Firebase، فسيتم توفير مصادر بيانات جديدة في موقع Google Analytics لكل تطبيق من تطبيقات Firebase. لاحظ أنه يتم دائمًا توفير مصدر بيانات جديد لتطبيق ويب حتى إذا كان مرتبطًا مسبقًا بمصدر بيانات في موقع Analytics.

تعرف على المزيد حول التسلسل الهرمي وبنية حسابات Google Analytics في وثائق Analytics .

نتيجة هذه المكالمة هي Operation . استقصاء Operation لتتبع عملية التزويد عن طريق استدعاء operations.get حتى يتم true done . عندما done true ، تكون Operation قد نجحت أو فشلت. إذا نجحت Operation ، فسيتم تعيين response على AnalyticsDetails ؛ إذا فشلت Operation ، فسيتم تعيين error الخاص بها على google.rpc.Status .

للاتصال بـ projects.addGoogleAnalytics ، يجب أن يكون عضو المشروع مالكًا لـ FirebaseProject الحالي وأن يكون لديه إذن Edit لحساب Google Analytics.

إذا تم تمكين Google Analytics بالفعل في FirebaseProject ، وقمت باستدعاء projects.addGoogleAnalytics باستخدام analyticsPropertyId الذي يختلف عن الخاصية المرتبطة حاليًا، فسوف يفشل الاستدعاء. ربما تم تمكين التحليلات بالفعل في وحدة تحكم Firebase أو عن طريق تحديد timeZone ورمز regionCode في استدعاء projects.addFirebase .

طلب HTTP

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics

يستخدم عنوان URL بناء جملة gRPC Transcoding .

معلمات المسار

حدود
parent

string

اسم المورد الخاص بـ FirebaseProject للربط بحساب Google Analytics موجود، بالتنسيق:

projects/ PROJECT_IDENTIFIER

ارجع إلى حقل name FirebaseProject للحصول على تفاصيل حول قيم PROJECT_IDENTIFIER .

هيئة الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل جيسون
{

  // Union field analytics_resource can be only one of the following:
  "analyticsAccountId": string,
  "analyticsPropertyId": string
  // End of list of possible types for union field analytics_resource.
}
مجالات
Union field analytics_resource .

يمكن تحديد مورد Google Analytics واحد فقط في نص الطلب.
  • لتوفير موقع Google Analytics جديد وربطه بـ FirebaseProject ، قم بتوفير analyticsAccountId .
  • لربط موقع حالي في Google Analytics بـ FirebaseProject ، قم بتوفير analyticsPropertyId .


يمكن أن يكون analytics_resource واحدًا فقط مما يلي:
analyticsAccountId

string

معرف حساب Google Analytics الحالي الذي تريد ربطه بـ FirebaseProject .

سيؤدي تحديد هذا الحقل إلى توفير موقع Google Analytics جديد في حسابك في Google Analytics وربط الموقع الجديد بـ FirebaseProject .

analyticsPropertyId

string

الرقم التعريفي لموقع Google Analytics الحالي الذي تريد ربطه بـ FirebaseProject .

هيئة الاستجابة

في حالة النجاح، يحتوي نص الاستجابة على مثيل Operation .

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

لمزيد من المعلومات، راجع نظرة عامة على المصادقة .