واجهة برمجة التطبيقات للإدارة
هذا هو الدليل المرجعي للإصدار 3.0 من واجهة برمجة التطبيقات Management API. وهو يوفّر تفاصيل كاملة حول طلبات البحث والردود على بيانات ضبط "إحصاءات Google". للحصول على دليل للمفاهيم وبنية بيانات الإعداد، يُرجى الاطّلاع على الإصدار 3.0 نظرة عامة.
يحدد كل قسم في هذا الدليل طريقة الطلب والاستجابة لنوع واحد من الكيانات في بيانات الإعداد لمستخدم تمت مصادقته. وتظهر الطلبات جميعها بتنسيق REST. في نهاية الصفحة لكل طريقة، يمكنك تجربة الطلب تفاعليًا في مستكشف واجهات برمجة التطبيقات باستخدام الرابط "& جرِّب بنفسك".
أنواع الموارد
- ملخّصات الحساب
- روابط مستخدم الحساب
- الحسابات
- روابط AdWords
- مصادر البيانات المخصّصة
- المكوّنات المخصّصة
- المقاييس المخصّصة
- التجارب
- الفلاتر
- الأهداف
- معرّف العميل
- روابط فلاتر الملفات الشخصية
- روابط ملفات المستخدمين
- شرائح جمهور تجديد النشاط التسويقي
- الشرائح
- التقارير غير المستندة إلى عينات
- عمليات التحميل
- الملفات الشخصية (الملفات الشخصية)
- المواقع الإلكترونية
- روابط المستخدم في الموقع الإلكتروني
ملخّصات الحساب
لمعرفة تفاصيل مورد "ملخّصات الحساب"، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب 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
|
يعدّل الأذونات لمستخدم حالي في الحساب المحدد. |
حسابات
لمعرفة تفاصيل موارد الحسابات، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرفات الموارد المنتظمة (URI) مقارنةً بـ https://www.googleapis.com/analytics/v3، ما لم يُذكر غير ذلك | ||
| list |
GET /management/accounts
|
يعرض جميع الحسابات التي يمتلك المستخدم حق الوصول إليها. |
روابط AdWords
لمعرفة تفاصيل "موارد روابط 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
|
إنشاء رابط webProperty-AdWords. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
|
يعرض روابط webProperty-AdWords لموقع إلكتروني معيّن. |
| رمز تصحيح |
PATCH /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
تعديل رابط webProperty-AdWords الحالي. تتيح هذه الطريقة دلالات التصحيح. |
| تحديث |
PUT /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
تعديل رابط webProperty-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
|
إدراج عمليات التحميل التي يمكن للمستخدم الوصول إليها. |
| تحميل البيانات |
POST
|
تحميل البيانات لمصدر بيانات مخصص. |
الملفات الشخصية (الملفات الشخصية)
لمعرفة تفاصيل الموارد (الملفات الشخصية)، اطلع على صفحة تمثيل المورد.
| الطريقة | طلب 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
|
يسرد روابط webProperty-user لموقع ويب معيّن. |
| تحديث |
PUT /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId
|
تعديل الأذونات لمستخدم حالي على موقع إلكتروني معيّن. |