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

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

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

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

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

للحصول على إعلانات Google Analytics API الرسمية، اشترِك في مجموعة إشعارات Google Analytics API.

مقدمة

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

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

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

العرض ربط حساب معلِن Video 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 على "إحصاءات 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" المبرمَجة لموقع Universal Analytics.