نظرة عامة حول واجهة برمجة تطبيقات المشرف في "إحصاءات 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 (الإصدار الأولي).
• تدقيق أذونات المستخدمين بما في ذلك الأذونات الضمنية التي تأتي من أذونات فعّالة تمنحها المجموعات أو أدوار مشرف المؤسسة (الإصدار الأولي).
• إنشاء تقارير الوصول إلى البيانات (الإصدار الأولي).

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

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

• 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.getDataالاحتفاظSettings
• properties.updateDataالاحتفاظ بالبيانات

إدارة إعدادات "إشارات 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.الموافقة
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

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

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

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

• accounts.userLinks.create
• accounts.userLinks.get
• accounts.userLinks.list
• accounts.userLinks.patch
• accounts.userLinks.delete
• accounts.userLinks.batchCreate
• accounts.userLinks.batchGet
• accounts.userLinks.batchUpdate

• accounts.userLinks.batchDelete

• properties.userLinks.create

• properties.userLinks.get

• properties.userLinks.list

• properties.userLinks.delete

• properties.userLinks.patch

• properties.userLinks.batchCreate

• properties.userLinks.batchGet

• properties.userLinks.batchUpdate

• properties.userLinks.batchDelete

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

• accounts.userLinks.audit
• properties.userLinks.audit

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

• properties.runAccessReport اطلع على دليل تقارير الوصول إلى البيانات للحصول على مزيد من المعلومات حول هذه الميزة.