نظرة عامة حول واجهة برمجة تطبيقات المشرف في "إحصاءات Google"

ملخص: يقدم هذا المستند نظرة عامة عالية المستوى على الإصدار 1.0 من واجهة برمجة تطبيقات المشرف في "إحصاءات Google".

تحذير: هذا إصدار مبكر مبكر من واجهة برمجة التطبيقات ويخضع للتغيير. وسنحاول إبلاغك بالتغييرات القادمة، ولكن من المفترض أن تلاحظ حدوث تغييرات قد تؤدي إلى أعطال قبل طرح واجهات برمجة التطبيقات للجميع.

ستظل كل من القنوات الأولية والتجريبية من واجهة برمجة التطبيقات متاحة. تحتوي القناة التجريبية على مجموعة فرعية من الميزات المتوفّرة في الإصدار الأولي التي تُعتبر ثابتة ولا يُتوقع أن تخضع لتغيير كبير في المستقبل. وستتم إضافة ميزات جديدة إلى الإصدار التجريبي عندما تصبح متوافقة.

بالنسبة إلى الإشعارات الرسمية من Google Analytics API، يُرجى الاشتراك في مجموعة إشعارات Google Analytics API. للإبلاغ عن مشكلة في واجهة برمجة التطبيقات، استخدِم نموذج الملاحظات بشأن أداة اختبار واجهة برمجة تطبيقات "إحصاءات Google".

المقدمة

تسمح واجهة برمجة التطبيقات للمشرف على "إحصاءات Google" بالوصول آليًا إلى بيانات إعدادات "إحصاءات Google 4" (GA4)، ولا تتوافق إلا مع مواقع "إحصاءات Google 4". اطّلِع على مزيد من المعلومات عن مواقع "إحصاءات Google 4" (GA4).

يمكنك استخدام واجهة برمجة التطبيقات الإدارية في "إحصاءات Google" لإجراء ما يلي:

• توفير حسابات جديدة:
• إدارة الحسابات
• إدارة إعدادات مشاركة البيانات
• اعرض ملخّصات الحسابات.
• البحث في أحداث سجلّ التغييرات
• إدارة المواقع الإلكترونية
• الإقرار بجمع بيانات المستخدمين
• إدارة إعداد الاحتفاظ بالبيانات لأحد المواقع
• إدارة إعداد "إشارات Google" لأحد المواقع (الإصدار الأولي).
• إدارة أحداث البث
• إدارة واجهات برمجة التطبيقات السرّية التي تخصّ Measurement Protocol
• أنشئ مقتطف علامة Google لمصادر بيانات الويب (الإصدار الأولي).
• إدارة أحداث الإحالات الناجحة:
• إدارة السمات المخصّصة
• إدارة المقاييس المخصّصة
• إدارة عمليات الربط بين مواقع "إحصاءات Google" 4 والمشاريع على Firebase
• إدارة عمليات الربط بين مواقع "إحصاءات Google 4" (GA4) وحسابات "إعلانات Google"
• يمكنك إدارة اقتراحات الربط بين موقع على "إحصاءات Google 4" (GA4) ومعلِن على "مساحة العرض والفيديو 360" (الإصدار الأولي).
• إدارة الروابط بين موقع على "إحصاءات Google 4" (GA4) ومعلِن على "مساحة العرض والفيديو 360" (الإصدار الأولي).
• إدارة الروابط بين موقع على "إحصاءات Google 4" (GA4) و"إعلانات شبكة البحث 360" (الإصدار الأولي).
• إدارة الروابط بين موقع على "إحصاءات Google" 4 ومشروع BigQuery (الإصدار الأولي)
• إدارة أذونات المستخدمين للعرض الهرمي للحساب ومواقع "إحصاءات Google" 4 (الإصدار الأولي).
• إنشاء تقارير الوصول إلى البيانات (الإصدار الأولي)
• إدارة شرائح الجمهور (الإصدار الأولي)
• إدارة مجموعات البيانات الموسّعة (الإصدار الأولي)
• إدارة إعدادات إيقاف عملية "إحصاءات Google 4" المبرمَجة (الإصدار الأولي)

الطرق المتاحة

إدارة الحسابات

• accounts.provisionAccountTicket

  تعرض هذه الطريقة الحقل accountTicketId الذي يجب تضمينه في عنوان URL لبنود الخدمة: https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID. بعد زيارة المستخدم لعنوان URL لبنود الخدمة وقبول بنود الخدمة، سينتهي إنشاء حساب على "إحصاءات Google" (نموذج توفير الحسابات).

إدارة الحسابات

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

إدارة إعدادات مشاركة البيانات

• accounts.getDataSharingSettings

عرض ملخّصات الحساب

• accountSummaries.list

البحث في أحداث السجلّ

• accounts.searchChangeHistoryEvents

إدارة العقارات

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

إقرار جمع بيانات المستخدمين

• properties.acknowledgeUserDataCollection

إدارة إعدادات الاحتفاظ بالبيانات

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

إدارة إعدادات "إشارات Google" (الإصدار الأولي)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

إدارة مصادر البيانات

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

إدارة أسرار Measurement Protocol

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

إدارة أحداث الإحالات الناجحة

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete

إدارة السمات المخصّصة

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

إدارة المقاييس المخصّصة

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

ربط مشروع Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

ربط حساب "إعلانات Google"

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

إنشاء علامات Google (الإصدار الأولي)

• properties.webDataStreams.getGlobalSiteTag

اقتراحات للربط بين موقع على "إحصاءات Google 4" (GA4) ومعلِن على "مساحة العرض والفيديو 360" (الإصدار الأولي)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

ربط حساب المعلِن على "مساحة العرض والفيديو 360" (الإصدار الأولي)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

ربط حساب "إعلانات شبكة البحث 360" (الإصدار الأولي)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

اطّلِع على مزيد من المعلومات عن إعداد عملية الدمج مع "إعلانات Google" في "إعلانات شبكة البحث 360" لموقع على "إحصاءات Google 4".

ربط حساب BigQuery (الإصدار الأولي)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

اطّلِع على مزيد من المعلومات عن إعداد BigQuery Export لموقع "إحصاءات Google 4" (GA4).

إدارة أذونات المستخدمين (الإصدار الأولي)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

تقارير الوصول إلى البيانات (الإصدار الأولي)

• properties.runAccessReport

راجع دليل تقارير الوصول إلى البيانات لمزيد من المعلومات عن هذه الميزة.

إدارة الجمهور (الإصدار الأولي)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

اطّلِع على مزيد من المعلومات عن شرائح الجمهور في "إحصاءات Google".

إدارة مجموعات البيانات الموسَّعة (الإصدار الأولي)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

اطّلِع على مزيد من المعلومات عن مجموعات البيانات الموسّعة في "إحصاءات Google 360".

إيقاف عملية إعداد "إحصاءات Google 4" المبرمَجة (الإصدار الأولي)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

اطّلِع على مزيد من المعلومات عن إدارة حالة الإيقاف لعملية إعداد "إحصاءات Google 4" المبرمَجة لموقع على Universal Analytics.