نظرة عامة حول واجهة برمجة تطبيقات المشرف في "إحصاءات Google"

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

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

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

للاطّلاع على الإشعارات الرسمية حول واجهة برمجة التطبيقات الخاصة بخدمة "إحصاءات Google"، يُرجى الاشتراك في مجموعة الإشعارات الخاصة بواجهة برمجة تطبيقات "إحصاءات Google". للإبلاغ عن مشكلة في واجهة برمجة التطبيقات، استخدِم نموذج الملاحظات والآراء حول أداة اختبار واجهة برمجة تطبيقات "إحصاءات Google".

المقدمة

تتيح Google Analytics Admin API إمكانية الوصول الآلي إلى بيانات ضبط "إحصاءات Google 4" (GA4)، وهي متوافقة فقط مع مواقع "إحصاءات Google 4". اطّلِع على مزيد من المعلومات عن مواقع "إحصاءات Google 4".

يمكنك استخدام Google Analytics Admin API لتنفيذ ما يلي:

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