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

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

توفّر واجهة برمجة التطبيقات هذه حاليًا ميزات متوفرة في قنوات الإصدار الأولي والتجريبي.

الإصدار الأولي

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

إصدار تجريبي

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

للاطّلاع على الإشعارات الرسمية حول Google Analytics API، يُرجى الاشتراك في مجموعة إشعارات Google Analytics API.

مقدمة

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

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

• إدارة الحسابات الجديدة:
• إدارة الحسابات
• إدارة إعدادات مشاركة البيانات
• قائمة ملخصات الحسابات:
• البحث في أحداث سجلّ التغييرات:
• إدارة المواقع:
• الموافقة على عملية جمع بيانات المستخدمين:
• إدارة إعدادات الاحتفاظ بالبيانات لأحد المواقع
• إدارة إعداد "إشارات Google" لأحد المواقع (إصدار أولي).
• إدارة ساحات المشاركات
• إدارة أسرار Measurement Protocol.
• إدارة مخطّط قيمة الإحالة الناجحة على SKAdNetwork (الإصدار الأولي)
• أنشئ مقتطف علامة Google لمصادر بيانات الويب (الإصدار الأولي).
• إدارة أحداث الإحالات الناجحة
• إدارة السمات المخصّصة:
• إدارة المقاييس المخصَّصة:
• إدارة عمليات الربط بين المواقع على "إحصاءات Google 4" والمشاريع على Firebase
• إدارة عمليات الربط بين مواقع "إحصاءات Google 4" وحسابات "إعلانات Google":
• إدارة اقتراحات الربط بين موقع على "إحصاءات Google 4" ومُعلِن على "مساحة العرض والفيديو 360" (إصدار أولي).
• إدارة عمليات الربط بين موقع على "إحصاءات Google 4" ومعلِن على "مساحة العرض والفيديو 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

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

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

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

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

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

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