Method: properties.fetchConnectedGa4Property
استنادًا إلى موقع UA محدّد، ابحث عن موقع "إحصاءات Google 4" المرتبط به. ملاحظة: لا يمكن استخدام هذا مع مواقع "إحصاءات Google 4".
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/properties:fetchConnectedGa4Property
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المعلمات |
property |
string
مطلوب. موقع UA الذي يمكن البحث فيه عن موقع "إحصاءات Google 4" المرتبط لاحظ أن هذا الطلب يستخدم رقم تعريف الموقع الداخلي، وليس رقم تعريف التتبع للنموذج UA-XXXXXX-YY. التنسيق: المواقع/{internal_web_property_id} مثال: المواقع/1234
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ للبحث عن موقع على "إحصاءات Google 4" مرتبط بموقع على Universal Analytics.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"property": string
} |
الحقول |
property |
string
موقع "إحصاءات Google 4" المرتبط بموقع Universal Analytics يتمّ عرض سلسلة فارغة في حال عدم توفّر موقع مرتبط على "إحصاءات Google 4". التنسيق: المواقع/{property_id} مثال: المواقع/1234
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This document details how to look up the connected Google Analytics 4 (GA4) property for a given Universal Analytics (UA) property using the Google Analytics Admin API."],["The API request requires the internal UA property ID and returns the connected GA4 property ID, if any."],["Authentication requires specific OAuth scopes for either read-only or edit access to Analytics data."],["It is important to note that this functionality cannot be used with GA4 properties and requires an empty request body."]]],["This document details how to find a connected GA4 property using its associated UA property. A `GET` request to `https://analyticsadmin.googleapis.com/v1alpha/properties:fetchConnectedGa4Property` is made. The request requires a `property` query parameter, which is the UA property's internal ID, formatted as `properties/{internal_web_property_id}`. The request body must be empty. The response body returns a JSON structure containing a `property` field with the GA4 property ID or an empty string if none exists. The request needs authorization with specific OAuth scopes.\n"]]