API Reference

واجهة برمجة تطبيقات الإدارة

هذا هو الدليل المرجعي للإصدار 3.0 من Management API. وهي توفِّر تفاصيل كاملة حول طلبات البحث والردود لبيانات إعداد "إحصاءات Google". للحصول على دليل حول المفاهيم وبنية بيانات الضبط، يُرجى الاطِّلاع على الإصدار 3.0 نظرة عامة.

يحدد كل قسم في هذا الدليل طريقة الطلب والاستجابة لنوع واحد من الكيانات في بيانات الإعداد لمستخدم تمت مصادقته. تظهر جميع الطلبات بتنسيق REST. في نهاية كل طريقة، يمكنك تجربة الطلب بشكل تفاعلي في مستكشف واجهات برمجة التطبيقات باستخدام الرابط "جرِّبه!".

أنواع الموارد

  1. ملخّصات الحسابات
  2. روابط مستخدمي الحساب
  3. الحسابات
  4. روابط AdWords
  5. مصادر البيانات المخصّصة
  6. الأبعاد المخصّصة
  7. المقاييس المخصَّصة
  8. التجارب
  9. الفلاتر
  10. الأهداف
  11. معرّف العميل
  12. روابط فلاتر الملفات الشخصية
  13. روابط مستخدمي الملف الشخصي
  14. شرائح جمهور تجديد النشاط التسويقي
  15. الشرائح
  16. التقارير غير المستندة إلى عينات
  17. عمليات التحميل
  18. الملفات الشخصية (الملفات الشخصية)
  19. المواقع الإلكترونية
  20. روابط مستخدمي المواقع الإلكترونية

ملخّصات الحسابات

للحصول على تفاصيل موارد "ملخّصات الحساب"، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
list GET  /management/accountSummaries يسرد ملخّصات الحسابات (شجرة بسيطة تتألف من الحسابات/المواقع/الملفات الشخصية) التي يمكن للمستخدِم الوصول إليها.

بالنسبة إلى تفاصيل "موارد روابط المستخدمين للحساب"، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/entityUserLinks/linkId إزالة مستخدِم من الحساب المحدّد
إدراج POST  /management/accounts/accountId/entityUserLinks تتم إضافة مستخدم جديد إلى الحساب المحدد إذا كان المستخدم يمتلك أقل من 100 حساب.
list GET  /management/accounts/accountId/entityUserLinks يسرد روابط مستخدمي الحسابات لحساب معيّن.
تعديل PUT  /management/accounts/accountId/entityUserLinks/linkId يعدِّل الأذونات لمستخدم حالي في الحساب المحدّد.

Accounts

للحصول على تفاصيل موارد الحسابات، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
list GET  /management/accounts يسرد جميع الحسابات التي يمكن للمستخدم الوصول إليها.

للحصول على تفاصيل موارد روابط AdWords، اطّلع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId حذف رابط موقع إلكتروني-AdWords.
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId لعرض رابط موقع إلكتروني ضمن AdWords يمكن للمستخدم الوصول إليه.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks ينشئ رابطًا على موقع ويب-AdWords.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks يسرد روابط webالموقع-AdWords لموقع ويب معيّن.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId لتعديل رابط حالي على الموقع الإلكتروني-AdWords. تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId لتعديل رابط حالي على الموقع الإلكتروني-AdWords.

مصادر البيانات المخصصة

لمعرفة تفاصيل موارد مصادر البيانات المخصّصة، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources أدرج مصادر البيانات المخصّصة التي يمكن للمستخدم الوصول إليها.

الأبعاد المخصّصة

لمعرفة تفاصيل موارد السمات المخصّصة، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId احصل على سمة مخصّصة يمكن للمستخدم الوصول إليها.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions أنشِئ سمة مخصَّصة جديدة.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions يسرد السمات المخصّصة التي يمكن للمستخدِم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId تُعدِّل سمة مخصَّصة حالية. تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId تُعدِّل سمة مخصَّصة حالية.

المقاييس المخصّصة

لمعرفة تفاصيل مورد المقاييس المخصَّصة، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId احصل على مقياس مخصَّص يمكن للمستخدم الوصول إليه.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics إنشاء مقياس مخصّص جديد
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics يسرد المقاييس المخصّصة التي يمكن للمستخدم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId تعديل مقياس مخصّص حالي تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId تعديل مقياس مخصّص حالي

التجارب

للاطّلاع على تفاصيل موارد التجارب، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId حذف تجربة
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId تعرض تجربة يمكن للمستخدِم الوصول إليها.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments أنشئ تجربة جديدة.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments يسرد التجارب التي يمكن للمستخدم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId عدِّل تجربة حالية. تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId عدِّل تجربة حالية.

الفلاتر

للحصول على تفاصيل موارد الفلاتر، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/filters/filterId حذف فلتر
الحصول على GET  /management/accounts/accountId/filters/filterId تعرض فلاتر يمكن للمستخدم الوصول إليها.
إدراج POST  /management/accounts/accountId/filters إنشاء فلتر جديد
list GET  /management/accounts/accountId/filters يسرد جميع الفلاتر لحساب
حزمة PATCH  /management/accounts/accountId/filters/filterId لتعديل فلتر حالي تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/filters/filterId لتعديل فلتر حالي

الأهداف

بالنسبة إلى تفاصيل موارد الأهداف، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId يحصل على هدف يمكن للمستخدم الوصول إليه.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals أنشئ هدفًا جديدًا.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals يسرد الأهداف التي يمكن للمستخدم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId لتعديل هدف حالي تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId لتعديل هدف حالي

معرِّف العميل

لمعرفة تفاصيل مورد Management.clientId، يُرجى الاطّلاع على صفحة تمثيل المورد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
hashClientId POST  /management/clientId:hashClientId تجزّئ معرّف العميل المحدّد.

للتعرّف على تفاصيل موارد روابط فلاتر الملفات الشخصية، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId حذف رابط فلتر الملف الشخصي
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId تعرض رابطًا واحدًا لفلتر الملف الشخصي.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks إنشاء رابط فلتر جديد للملف الشخصي.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks يسرد جميع روابط فلاتر الملف الشخصي للملف الشخصي.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId عدِّل رابط فلتر ملف شخصي حالي. تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId عدِّل رابط فلتر ملف شخصي حالي.

للتعرّف على تفاصيل "موارد روابط المستخدمين في الملف الشخصي"، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId إزالة مستخدم من الملف الشخصي المحدّد
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks يضيف مستخدمًا جديدًا إلى الملف الشخصي المحدّد.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks يسرد روابط مستخدمي الملف الشخصي لملف شخصي معيّن.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId يحدّث الأذونات لمستخدم حالي في الملف الشخصي المحدّد.

جماهير تجديد النشاط التسويقي

للحصول على تفاصيل موارد شرائح جمهور تجديد النشاط التسويقي، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId حذف شريحة جمهور تجديد نشاط تسويقي.
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId الحصول على شريحة جمهور لتجديد النشاط التسويقي يمكن للمستخدم الوصول إليها
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences إنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي
list GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences يسرد شرائح جمهور تجديد النشاط التسويقي التي يمكن للمستخدم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId تعديل شريحة جمهور حالية لتجديد النشاط التسويقي تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId تعديل شريحة جمهور حالية لتجديد النشاط التسويقي

الشرائح

للحصول على تفاصيل موارد الشرائح، اطلع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
list GET  /management/segments يسرد الشرائح التي يمكن للمستخدم الوصول إليها.

التقارير غير المستندة إلى عينات

للحصول على تفاصيل موارد التقارير غير المستندة إلى عينات، راجع صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId حذف تقرير غير مستند إلى عينات.
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId تعرض تقريرًا واحدًا غير مستند إلى عينات.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports إنشاء تقرير جديد غير مستند إلى عينات.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports يسرد التقارير غير المستندة إلى عينات التي يمكن للمستخدم الوصول إليها.

الفيديوهات المحمّلة

لمعرفة تفاصيل مورد عمليات التحميل، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData يمكنك حذف البيانات المرتبطة بعملية تحميل سابقة.
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId سرد عمليات التحميل التي يمكن للمستخدم الوصول إليها
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads سرد عمليات التحميل التي يمكن للمستخدم الوصول إليها
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
تحميل البيانات لمصدر بيانات مخصّص

المشاهدات (الملفات الشخصية)

للحصول على تفاصيل موارد الملفات الشخصية (الملفات الشخصية)، يمكنك الاطلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId حذف ملف شخصي.
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId يحصل على ملف شخصي (الملف الشخصي) يمكن للمستخدم الوصول إليه.
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/profiles إنشاء ملف شخصي جديد.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles يسرد الملفات الشخصية التي يمكن للمستخدم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId يؤدي إلى تعديل ملف شخصي حالي. تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId يؤدي إلى تعديل ملف شخصي حالي.

المواقع الإلكترونية

لمعرفة تفاصيل موارد مواقع الويب، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
الحصول على GET  /management/accounts/accountId/webproperties/webPropertyId الحصول على موقع يمكن للمستخدم الوصول إليه
إدراج POST  /management/accounts/accountId/webproperties ينشئ موقعًا جديدًا.
list GET  /management/accounts/accountId/webproperties يسرد الخصائص التي يمكن للمستخدم الوصول إليها.
حزمة PATCH  /management/accounts/accountId/webproperties/webPropertyId لتعديل موقع حالي تدعم هذه الطريقة دلالات التصحيح.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId لتعديل موقع حالي

بالنسبة إلى تفاصيل موارد روابط المستخدمين للمواقع الإلكترونية، يُرجى الاطّلاع على صفحة تمثيل المورد.

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر خلاف ذلك
حذف DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId إزالة مستخدِم من الموقع الإلكتروني المحدّد
إدراج POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks يضيف مستخدمًا جديدًا إلى الموقع الإلكتروني المعني.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks يسرد روابط مستخدمي موقع الويب لموقع ويب معيّن.
تعديل PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId يعدِّل الأذونات لمستخدِم حالي في الموقع الإلكتروني المعنيّ.