نظرة عامة على Google Analytics Admin API

الملخّص: يقدّم هذا المستند نظرة عامة على المستوى الأعلى من الإصدار 1.0 من Google Analytics Admin API.

توفّر واجهة برمجة التطبيقات هذه ميزات في قنوات الإصدار الأوّلي والقناة التجريبية. قد يكون الدعم المقدّم لمنتجات الإصدار الأولي والإصدار التجريبي محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على هذه المنتجات متوافقة مع الإصدارات الأخرى من هذه المنتجات.

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

الإصدار التجريبي: لا يُتوقّع حدوث تغيير قد يؤدي إلى عطل في هذه القناة.

للاطّلاع على الإشعارات الرسمية بشأن Google Analytics API، اشترِك في مجموعة إشعارات Google Analytics API.

مقدمة

تتيح واجهة برمجة التطبيقات الإدارية في "إحصاءات Google" الوصول آليًا إلى بيانات الإعدادات في "إحصاءات Google"، وهي متوافقة فقط مع مواقع "إحصاءات Google". مزيد من المعلومات عن المواقع على "إحصاءات Google"

يمكنك استخدام Google Analytics Admin API لإجراء ما يلي:

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

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

في ما يلي الطرق المتاحة.

توفير الحساب

• 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.provisionSubproperty

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

• 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

إدارة مخطّط قيمة الإحالة الناجحة في SKAdNetwork (إصدار أوّلي)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

إدارة الأحداث الرئيسية

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

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

متوقّف نهائيًا: استخدِم المورد KeyEvent والطُرق بدلاً من ذلك.

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

إدارة قواعد إنشاء الأحداث (إصدار أوّلي)

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

إدارة قواعد تعديل الأحداث (إصدار أوّلي)

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

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

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

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

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

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

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

• 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" (إصدار أوّلي)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

مزيد من المعلومات حول إدارة حالة إيقاف عملية الإعداد التلقائي في "إحصاءات Google" لموقع UA.