واجهة برمجة تطبيقات الإدارة
هذا هو الدليل المرجعي للإصدار 3.0 من Management API. ويوفر تفاصيل كاملة حول طلبات البحث والردود لبيانات تهيئة Google Analytics. للحصول على دليل للمفاهيم وبنية بيانات الضبط، يُرجى الاطّلاع على الإصدار 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
|
يعدِّل الأذونات لمستخدم حالي في الحساب المحدّد. |
Accounts
للحصول على تفاصيل موارد الحسابات، يُرجى الاطّلاع على صفحة تمثيل الموارد.
الطريقة | طلب 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
|
ينشئ رابطًا بين موقع الويب وAdWords. |
list |
GET /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
|
يسرد روابط موقع الويب-إعلانات AdWords لموقع ويب معين. |
تصحيح |
PATCH /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
لتعديل رابط حالي على webالموقع الإلكتروني في AdWords تدعم هذه الطريقة دلالات التصحيح. |
تعديل |
PUT /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
لتعديل رابط حالي على webالموقع الإلكتروني في 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
|
يُرجى تحميل البيانات لمصدر بيانات مخصّص. |
المشاهدات (الملفات الشخصية)
بالنسبة إلى تفاصيل موارد الملفات الشخصية (الملفات الشخصية)، يُرجى الاطّلاع على صفحة تمثيل الموارد.
الطريقة | طلب 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
|
يعدِّل الأذونات لمستخدم حالي على الموقع الإلكتروني المحدّد. |