ربط FirebaseProject
المحدد بحساب Google Analytics موجود.
باستخدام هذه المكالمة، يمكنك إما:
- حدد
analyticsAccountId
لتوفير موقع Google Analytics جديد ضمن الحساب المحدد وربط الموقع الجديد بـFirebaseProject
. - حدد
analyticsPropertyId
الموجود لربط الخاصية بـFirebaseProject
.
لاحظ أنه عند الاتصال projects.addGoogleAnalytics
:
- يحدد الفحص الأول ما إذا كانت أي مصادر بيانات موجودة في موقع Google Analytics تتوافق مع أي تطبيقات Firebase موجودة في
FirebaseProject
(استنادًا إلىpackageName
أوbundleId
المرتبط بمصدر البيانات). وبعد ذلك، حسب الاقتضاء، يتم ربط مصادر البيانات والتطبيقات. لاحظ أن هذا الارتباط التلقائي ينطبق فقط علىAndroidApps
وIosApps
. - إذا لم يتم العثور على مصادر بيانات مقابلة لتطبيقات 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 | اسم المورد الخاص بـ ارجع إلى حقل |
هيئة الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل جيسون |
---|
{ // Union field |
مجالات | |
---|---|
Union field analytics_resource .يمكن تحديد مورد Google Analytics واحد فقط في نص الطلب.
يمكن أن يكون analytics_resource واحدًا فقط مما يلي: | |
analyticsAccountId | معرف حساب Google Analytics الحالي الذي تريد ربطه بـ سيؤدي تحديد هذا الحقل إلى توفير موقع Google Analytics جديد في حسابك في Google Analytics وربط الموقع الجديد بـ |
analyticsPropertyId | الرقم التعريفي لموقع Google Analytics الحالي الذي تريد ربطه بـ |
هيئة الاستجابة
في حالة النجاح، يحتوي نص الاستجابة على مثيل Operation
.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
-
https://www.googleapis.com/auth/cloud-platform
-
https://www.googleapis.com/auth/firebase
لمزيد من المعلومات، راجع نظرة عامة على المصادقة .