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

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

مقدمة

تتيح Google Analytics Admin API الوصول آليًا إلى بيانات إعداد "إحصاءات 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

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

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