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

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

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

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

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

المقدمة

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

يمكنك استخدام واجهة برمجة تطبيقات مشرف Google Analytics من أجل:

• إدارة حسابات جديدة:
• إدارة الحسابات.
• إدارة إعدادات مشاركة البيانات
• اسرد ملخّصات الحساب.
• البحث في أحداث سجل التغييرات.
• إدارة المواقع.
• الإقرار باستلام بيانات المستخدمين:
• إدارة إعداد الاحتفاظ بالبيانات لأحد المواقع.
• إدارة إعداد "إشارات 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 Analytics (نموذج إدارة الحسابات).

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

• 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 ومعلِن على "مساحة العرض والفيديو 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

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

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

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

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

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

• 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.audience.create
• properties.audience.archive
• properties.audience.patch
• properties.audience.list
• properties.audience.get

مزيد من المعلومات حول شرائح الجمهور في Google Analytics.

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

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

مزيد من المعلومات حول مجموعات البيانات الموسّعة في Google Analytics 360.

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

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

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