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 پیگیری کنید تا زمانی که done true باشد. هنگامی که done true باشد، Operation یا موفق شده یا شکست خورده است. اگر Operation موفقیت آمیز باشد، response آن روی AnalyticsDetails تنظیم می شود. اگر Operation ناموفق باشد، error آن روی google.rpc.Status تنظیم می شود.

برای فراخوانی projects.addGoogleAnalytics ، یک عضو پروژه باید مالک FirebaseProject موجود باشد و مجوز Edit حساب Google Analytics را داشته باشد.

اگر FirebaseProject قبلاً Google Analytics را فعال کرده باشد، و شما با استفاده از analyticsPropertyId که با ویژگی مرتبط فعلی متفاوت است، projects.addGoogleAnalytics را فراخوانی کنید، در این صورت تماس ناموفق خواهد بود. تجزیه و تحلیل ممکن است قبلاً در کنسول 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

برای جزئیات بیشتر در مورد مقادیر PROJECT_IDENTIFIER به قسمت name FirebaseProject مراجعه کنید.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{

  // 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.
}
زمینه های
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

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.