يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. معلومات
إعداد الأذونات لوكلاء الخدمة المحدَّدين
لإعداد الأذونات الخاصة بموظفي الخدمة المعيّنين، استعدادًا للتغييرات الموضّحة أعلاه، يُرجى تنفيذ الخطوات التالية.
- ابحث عن اسم وكيل خدمة Google Cloud من خلال إدخال
الأمر التالي:
curl -X GET \ "https://api.enterprise.apigee.com/v1/organizations/ORG" \ -u email:password \ | jq -r '.properties.property[] | select(.name=="serviceAgent.analytics") | .value'
كان ORG هو مؤسستك. تعرض هذه البيانات اسم وكيل الخدمة وقيمته كما هو موضّح أدناه:
"property" : [ { "name" : "serviceAgent.analytics", "value" : "service-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com" },
- افتح لوحة بيانات إدارة الهوية وإمكانية الوصول في Google Cloud Console.
- اختَر مشروعك على Google Cloud.
- انقر على إضافة في أعلى لوحة إدارة الهوية وإمكانية الوصول.
- في حقل العناصر الرئيسية الجديدة، أدخِل وكيل الخدمة
value
الذي تم عرضه في الخطوة 1. على سبيل المثال، القيمةvalue
المعروضة في الخطوة 1 هيservice-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com
. - انقر على الزر +إضافة دور آخر وأضِف الأدوار التالية:
- مستخدم BigQuery
- مشرف مساحة التخزين
- انقر على حفظ.
بيانات Apigee Analytics
تجمع Apigee Analytics وتحلل مجموعة واسعة من البيانات التي تتدفق عبر واجهات برمجة التطبيقات لديك، كما توفر أدوات العروض المرئية، بما في ذلك لوحات البيانات التفاعلية والتقارير المخصّصة والأدوات الأخرى التي تحدّد المؤشرات في أداء الخادم الوكيل لواجهة برمجة التطبيقات. يمكنك الآن الاستفادة من هذا المحتوى الغني من خلال تصدير بيانات الإحصاءات من Apigee Analytics إلى مستودع بياناتك، مثل Google Cloud Storage أو Google BigQuery. يمكنك بعد ذلك الاستفادة من إمكانات "تعلُّم الآلة وطلبات البحث الفعّالة" من Google BigQuery وTensorFlow لإجراء تحليل البيانات بنفسك. يمكنك أيضًا دمج بيانات الإحصاءات التي تم تصديرها مع بيانات أخرى، مثل سجلّات الويب، للحصول على إحصاءات جديدة حول المستخدمين وواجهات برمجة التطبيقات والتطبيقات.تنسيق بيانات التصدير
تصدير بيانات الإحصاءات إلى أحد التنسيقات التالية:
القيم المفصولة بفواصل (CSV)
المحدِّد الافتراضي هو حرف فاصلة (,). تشمل أحرف المُحدِّد المتوافقة الفاصلة (,) وعلامة الشرطة المستقيمة (|) وعلامة التبويب (\t). اضبط القيمة باستخدام السمة
csvDelimiter
، كما هو موضَّح في تصدير مرجع خاصية الطلب .JSON (محدّد بفواصل جديدة)
السماح باستخدام حرف السطر الجديد كمحدِّد.
وتشمل البيانات التي يتم تصديرها جميع مقاييس وسمات الإحصاءات المضمّنة في Edge، وأي بيانات تحليلات مخصّصة تضيفها. للحصول على وصف للبيانات التي يتم تصديرها، اطّلِع على مرجع المقاييس والسمات والفلاتر في "إحصاءات Google".
يمكنك تصدير بيانات الإحصاءات إلى مستودعات البيانات التالية:
نظرة عامة على عملية التصدير
تلخِّص الخطوات التالية العملية المستخدَمة لتصدير بيانات الإحصاءات:
اضبط مستودع بياناتك (Cloud Storage أو BigQuery) لتصدير البيانات. يجب التأكد من ضبط مستودع البيانات بشكل صحيح، وأن حساب الخدمة المستخدَم لكتابة البيانات في مستودع البيانات لديه الأذونات الصحيحة.
إنشاء مخزن بيانات يحدد خصائص مستودع البيانات (Cloud Storage أو BigQuery) الذي يتم من خلاله تصدير بياناتك، بما في ذلك بيانات الاعتماد المستخدمة للوصول إلى مستودع البيانات.
عند إنشاء مخزن بيانات، يمكنك تحميل بيانات اعتماد مستودع البيانات إلى Edge Credentials Vault لتخزينها بأمان. بعد ذلك، تستخدم آلية تصدير البيانات بيانات الاعتماد هذه لكتابة البيانات في مستودع البيانات لديك.
يمكنك استخدام واجهة برمجة التطبيقات لتصدير البيانات لبدء عملية تصدير البيانات. تعمل عملية تصدير البيانات بشكل غير متزامن في الخلفية.
يمكنك استخدام واجهة برمجة التطبيقات لتصدير البيانات لتحديد وقت اكتمال التصدير.
عند اكتمال عملية التصدير، اطّلِع على البيانات التي تم تصديرها في مستودع البيانات.
توضح الأقسام التالية هذه الخطوات بمزيد من التفصيل.
تهيئة مستودع البيانات
تعمل آلية تصدير بيانات الإحصاءات على كتابة البيانات إلى Cloud Storage أو BigQuery. وحتى تتم عملية الكتابة، يجب:
- أنشئ حساب خدمة على Google Cloud Platform.
- اضبط دور حساب الخدمة بحيث يمكنه الوصول إلى Cloud Storage أو BigQuery.
إنشاء حساب خدمة لـ Cloud Storage أو BigQuery
حساب الخدمة هو نوع من حسابات Google التي ينتمي إليها تطبيقك بدلاً من حساب مستخدم فردي. ثم يستخدم تطبيقك حساب الخدمة للوصول إلى خدمة.
يحتوي حساب الخدمة على مفتاح حساب خدمة يتم تمثيله بسلسلة JSON. عندما تنشئ مخزن بيانات Edge الذي يحدد الاتصال بمستودع البيانات لديك، فإنك تمرره لهذا المفتاح. بعد ذلك، تستخدم آلية تصدير البيانات المفتاح للوصول إلى مستودع البيانات.
يجب أن يكون حساب الخدمة المرتبط بالمفتاح مالكًا لمشروع Google Cloud Platform وأن يمتلك إذنًا بالتعديل في حزمة Google Cloud Storage. لإنشاء مفتاح خدمة وتنزيل الحمولة المطلوبة، يُرجى الاطّلاع على إنشاء مفاتيح حساب الخدمة وإدارتها في مستندات Google Cloud Platform.
على سبيل المثال، عند تنزيل المفتاح للمرة الأولى، سيتم تنسيقه ككائن JSON:
{ "type": "service_account", "project_id": "myProject", "private_key_id": "12312312", "private_key": "-----BEGIN PRIVATE KEY-----\n...", "client_email": "client_email@developer.gserviceaccount.com", "client_id": "879876769876", "auth_uri": "https://accounts.google.com/organizations/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2", "client_x509_cert_url": "https://www.googleapis.com" }
إعداد Google Cloud Storage
قبل أن تتمكن من تصدير البيانات إلى Google Cloud Storage:
- تأكّد من تفعيل واجهات برمجة التطبيقات في BigQuery وCloud Resource Manager في مشروع Google Cloud Platform. راجع تمكين واجهات برمجة التطبيقات للحصول على التعليمات. تستخدم Apigee واجهة برمجة تطبيقات BigQuery للاستفادة من ميزات BigQuery Export عند التصدير إلى Cloud Storage وCloud Resource Manager API للتحقّق من الإذن قبل كل عملية تصدير.
تأكد من تعيين حساب الخدمة للأدوار التالية:
- مستخدم المهمة في BigQuery
- منشئ عناصر التخزين
- مشرف مساحة التخزين (مطلوب فقط لاختبار متجر البيانات كما هو موضّح في اختبار إعدادات متجر البيانات. إذا كان هذا الدور واسعًا جدًا، يمكنك إضافة إذن "
storage.buckets.get
" إلى دور حالي بدلاً من ذلك.)
بدلاً من ذلك، إذا أردت تعديل دور حالي أو إنشاء دور مخصَّص، أضِف الأذونات التالية إلى الدور:
bigquery.jobs.create
storage.objects.create
storage.buckets.get
(مطلوبة فقط لاختبار مخزن البيانات كما هو موضح في اختبار إعداد متجر البيانات)
إعداد Google BigQuery
قبل أن تتمكن من تصدير البيانات إلى Google BigQuery:
- تأكّد من تفعيل واجهات برمجة التطبيقات في BigQuery وCloud Resource Manager في مشروع Google Cloud Platform. راجع تمكين واجهات برمجة التطبيقات للحصول على التعليمات. تستخدم Apigee واجهة برمجة تطبيقات Cloud Resource Manager API للتحقُّق من الأذونات قبل كل عملية تصدير.
- تأكَّد من تفعيل BigQuery API في مشروعك على Google Cloud Platform. راجع تفعيل واجهات برمجة التطبيقات وإيقافها للحصول على التعليمات.
تأكد من تعيين حساب الخدمة للأدوار التالية:
- مستخدم المهمة في BigQuery
- محرر بيانات BigQuery
إذا أردت تعديل دور حالي أو إنشاء دور مخصَّص، أضِف الأذونات التالية إلى الدور:
bigquery.datasets.create
bigquery.datasets.get
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.get
bigquery.tables.updateData
إنشاء مخزن بيانات
يحدد مخزن البيانات الاتصال بمستودع بيانات التصدير (Cloud Storage وBigQuery)، بما في ذلك بيانات الاعتماد المستخدَمة للوصول إلى مستودع البيانات.
لمحة عن أداة Edge Credentials Vault
يستخدم Edge أداة Vault لبيانات الاعتماد لتخزين بيانات الاعتماد المستخدَمة للوصول إلى مستودع بيانات التصدير بشكلٍ آمن. لكي تتمكن الخدمة من الوصول إلى بيانات الاعتماد في Edge Credentials Vault، يجب عليك تحديد مستهلك بيانات الاعتماد.
عند إنشاء مخزن بيانات باستخدام واجهة مستخدم Edge، كما هو موضح أدناه، يقوم Edge تلقائيًا بإنشاء المستهلك المستخدم للوصول إلى بيانات الاعتماد.
اختبار تهيئة مخزن بيانات
عند إنشاء مخزن البيانات، لا يختبر Edge أو يتحقق من صلاحية بيانات الاعتماد الخاصة بك وإعدادات مستودع البيانات. وهذا يعني أنه يمكنك إنشاء مخزن البيانات وعدم رصد أي أخطاء إلى أن يتم تنفيذ أول عملية تصدير للبيانات.
بدلاً من ذلك، اختبر تهيئة مخزن البيانات قبل إنشائه. يُعد الاختبار مفيدًا لأن عملية تصدير البيانات الكبيرة قد تستغرق وقتًا طويلاً. يمكنك إصلاح أي مشاكل في إعداداتك بسرعة عن طريق اختبار بيانات الاعتماد وإعدادات مخزن البيانات قبل البدء في تنزيل كميات كبيرة من البيانات.
إذا نجح الاختبار، فقم بإنشاء مخزن البيانات. وإذا تعذّر الاختبار، عليك إصلاح الأخطاء ثم إعادة اختبار الإعدادات. لن تنشئ مخزن البيانات إلا بعد نجاح الاختبارات.
لتفعيل ميزة الاختبار، عليك إجراء ما يلي:
- تأكَّد من تفعيل Cloud Resource Manager API في مشروعك على Google Cloud Platform. راجع تفعيل واجهات برمجة التطبيقات وإيقافها للحصول على التعليمات.
إنشاء مخزن بيانات
لإنشاء مخزن بيانات في واجهة المستخدم:
سجِّل الدخول إلى https://apigee.com/edge كمشرف مؤسسة واختَر مؤسستك.
ملاحظة: يجب أن تكون مشرفًا في مؤسسة Edge حتى تتمكّن من إنشاء مخزن بيانات.
اختر المشرف > مخزن بيانات "إحصاءات Google" من شريط التنقّل الأيمن. يتم عرض صفحة مخازن بيانات "إحصاءات Google".
انقر على الزر + إضافة مخزن بيانات. سيُطلب منك اختيار نوع مخزن البيانات:
اختر نوع استهداف بيانات التصدير:
- Google Cloud Storage
- Google BigQuery
تظهر صفحة الضبط:
أدخِل اسم مخزن البيانات.
اختيار بيانات الاعتماد المستخدَمة للوصول إلى مستودع البيانات تظهر قائمة منسدلة ببيانات الاعتماد المتاحة.
وتكون بيانات الاعتماد خاصة بنوع مستودع بيانات. يُرجى الاطِّلاع على إنشاء حساب خدمة لكل من Cloud Storage أو BigQuery للتعرُّف على المزيد من المعلومات.
إذا سبق لك تحميل بيانات الاعتماد، اختَر بيانات الاعتماد من القائمة المنسدلة. تأكد من تحديد بيانات الاعتماد المناسبة لنوع مستودع البيانات.
إذا كنت تضيف بيانات اعتماد جديدة إلى مخزن البيانات، اختَر إضافة بيانات اعتماد جديدة. في مربّع الحوار، أدخِل ما يلي:
- اسم بيانات الاعتماد
- محتوى بيانات الاعتماد هو مفتاح حساب خدمة JSON الخاص بمستودع البيانات كما هو محدَّد في إنشاء حساب خدمة لـ Cloud Storage أو BigQuery.
- انقر على إنشاء.
أدخِل السمات الخاصة بنوع مستودع البيانات:
- بالنسبة إلى Google Cloud Storage:
الموقع الوصف مطلوب؟ رقم تعريف المشروع رقم تعريف مشروع Google Cloud Platform لإنشاء مشروع Google Cloud Platform، يُرجى الاطّلاع على إنشاء المشاريع وإدارتها في مستندات Google Cloud Platform.
نعم اسم الحزمة اسم الحزمة في Cloud Storage التي تريد تصدير بيانات الإحصاءات إليها. يجب أن تكون الحزمة متوفِّرة قبل إجراء عملية تصدير للبيانات. لإنشاء حزمة في Cloud Storage، يُرجى الاطّلاع على مقالة إنشاء حِزم مساحة تخزين في مستندات Google Cloud Platform.
نعم المسار الدليل الذي يتم فيه تخزين بيانات الإحصاءات في حزمة Cloud Storage. نعم - بالنسبة إلى BigQuery:
الموقع الوصف مطلوب؟ رقم تعريف المشروع رقم تعريف مشروع Google Cloud Platform لإنشاء مشروع Google Cloud Platform، يُرجى الاطّلاع على إنشاء المشاريع وإدارتها في مستندات Google Cloud Platform.
نعم اسم مجموعة البيانات اسم مجموعة بيانات BigQuery التي تريد تصدير بيانات الإحصاءات إليها. تأكَّد من إنشاء مجموعة البيانات قبل طلب تصدير البيانات. لإنشاء مجموعة بيانات BigQuery، يُرجى الاطّلاع على إنشاء مجموعات البيانات واستخدامها في مستندات Google Cloud Platform.
نعم بادئة الجدول بادئة أسماء الجداول التي تم إنشاؤها لبيانات الإحصاءات في مجموعة بيانات BigQuery. نعم
- بالنسبة إلى Google Cloud Storage:
اختر اختبار الاتصال للتأكد من إمكانية استخدام بيانات الاعتماد للوصول إلى مستودع البيانات.
إذا كان الاختبار ناجحًا، احفظ مخزن البيانات.
إذا تعذّر الاختبار، أصلِح أي مشاكل ثم أعِد محاولة الاختبار. حرِّك مؤشر الماوس فوق رسالة الخطأ في واجهة المستخدم لعرض معلومات إضافية في تلميح.
بعد اجتياز اختبار الاتصال، احفظ مخزن البيانات.
تعديل مخزن بيانات
لتعديل مخزن بيانات:
سجِّل الدخول إلى https://apigee.com/edge كمشرف مؤسسة واختَر مؤسستك.
اختر المشرف > مخزن بيانات "إحصاءات Google" من شريط التنقّل الأيمن. يتم عرض صفحة مخازن بيانات "إحصاءات Google".
حرِّك مؤشر الماوس فوق عمود التعديل في التقرير المطلوب تعديله. يظهر رمز تعديل وحذف.
تعديل مخزن البيانات أو حذفه
إذا عدّلت مخزن البيانات، اختر اختبار الاتصال للتأكد من إمكانية استخدام بيانات الاعتماد للوصول إلى مخزن البيانات.
إذا كان الاختبار ناجحًا، يمكنك عرض نموذج البيانات في مستودع البيانات.
إذا تعذّر الاختبار، أصلِح أي مشاكل ثم أعِد محاولة الاختبار.
بعد اجتياز اختبار الاتصال، عدِّل مخزن البيانات.
تصدير بيانات الإحصاءات
لتصدير بيانات الإحصاءات، يمكنك إصدار طلب POST إلى
/analytics/exports
API. مرِّر المعلومات التالية في نص الطلب:
- اسم طلب التصدير ووصفه
- النطاق الزمني للبيانات المصدَّرة (يمكن أن تمتد القيمة ليوم واحد فقط)
- تنسيق البيانات التي تم تصديرها
- اسم تخزين البيانات
- ما إذا تم تفعيل ميزة تحقيق الربح في المؤسسة
في ما يلي أمثلة على طلبات التصدير. للحصول على وصف كامل لخصائص نص الطلب، يمكنك الاطّلاع على تصدير مرجع ملكية الطلب.
يكون الرد من POST في النموذج:
{
"self": "/organizations/myorg/environments/test/analytics/exports/a7c2f0dd-1b53-4917-9c42-a211b60ce35b",
"created": "2017-09-28T12:39:35Z",
"state": "enqueued"
}
يُرجى العِلم أنّ السمة state
في الاستجابة يتم ضبطها على enqueued
. يعمل طلب POST بشكل غير متزامن. يعني هذا أنّ التطبيق يستمر في العمل في الخلفية بعد أن يعرض الطلب ردًّا. تشمل القيم المحتملة للسمة state
ما يلي: enqueued
وrunning
وcompleted
وfailed
.
استخدِم عنوان URL المعروض في الموقع الإلكتروني self
للاطّلاع على حالة طلب تصدير البيانات، كما هو موضّح في مقالة عرض حالة طلب تصدير البيانات. وعند اكتمال الطلب، يتم ضبط قيمة السمة state
في الاستجابة على completed
. يمكنك بعد ذلك الوصول إلى بيانات الإحصاءات في مستودع بياناتك.
المثال 1: تصدير البيانات إلى Cloud Storage
يصدِّر الطلب التالي مجموعة كاملة من البيانات الأولية خلال آخر 24 ساعة من بيئة test في المؤسسة myorg. يتم تصدير المحتوى إلى Cloud Storage بتنسيق JSON:
curl -X POST -H "Content-Type:application/json" \ "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \ -d \ '{ "name": "Export raw results to Cloud Storage", "description": "Export raw results to Cloud Storage for last 24 hours", "dateRange": { "start": "2018-06-08", "end": "2018-06-09" }, "outputFormat": "json", "datastoreName": "My Cloud Storage data repository" }' \ -u orgAdminEmail:password
استخدِم عنوان URL المحدَّد من خلال السمة self
لمراقبة حالة المهمة كما هو موضّح في
عرض حالة طلب تصدير "إحصاءات Google".
المثال 2: تصدير البيانات إلى BigQuery
يصدّر الطلب التالي ملف CSV مفصولاً بفواصل إلى BigQuery:
curl -X POST -H "Content-Type:application/json" \ "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \ -d \ '{ "name": "Export query results to BigQuery", "description": "One-time export to BigQuery", "dateRange": { "start": "2018-06-08", "end": "2018-06-09" }, "outputFormat": "csv", "csvDelimiter": ",", "datastoreName": "My BigQuery data repository" }' \ -u orgAdminEmail:password
ملاحظة: يُنشئ ملف CSV الذي تم تصديره جدول BigQuery بالبادئة التالية:
<PREFIX>_<EXPORT_DATE>_api_<UUID>_from_<FROM_DATE>_to_<TO_DATE>
استخدِم عنوان URL المحدَّد من خلال السمة self
لمراقبة حالة المهمة كما هو موضّح في عرض حالة طلب تصدير الإحصاءات.
مثال 3: تصدير بيانات تحقيق الربح
في حال تفعيل تحقيق الربح المادي في بيئة في المؤسسة، يمكنك إجراء نوعين من عمليات تصدير البيانات:
- تصدير البيانات العادي كما هو موضّح في المثالين السابقين.
- يتم تصدير بيانات تحقيق الربح لتصدير البيانات الخاصة بتحقيق الربح.
لتصدير بيانات تحقيق الربح، حدِّد "dataset":"mint"
في حمولة الطلب. يجب أن توفّر المؤسسة والبيئة إمكانية تحقيق الربح من أجل ضبط هذا الخيار، وإلا احذف السمة dataset
من الحمولة:
'{ "name": "Export raw results to Cloud Storage", "description": "Export raw results to Cloud Storage for last 24 hours", "dateRange": { "start": "2018-06-08", "end": "2018-06-09" }, "outputFormat": "json", "datastoreName": "My Cloud Storage data repository", "dataset":"mint" }'
لمحة عن حصص واجهات برمجة التطبيقات للتصدير
لمنع الاستخدام المفرط لطلبات البيانات من واجهة برمجة التطبيقات لتصدير البيانات المكلفة،
تفرض Edge حصة على طلبات البيانات من واجهة برمجة التطبيقات /analytics/exports
:
بالنسبة إلى المؤسسات والبيئات التي لم يتم تفعيل ميزة تحقيق الربح فيها، تكون الحصة:
- 70 اتصالاً في الشهر لكل مؤسسة/بيئة.
على سبيل المثال، إذا كانت لديك بيئتان في مؤسستك،
prod
وtest
، يمكنك إجراء 70 طلب بيانات من واجهة برمجة التطبيقات شهريًا لكل بيئة.بالنسبة إلى المؤسسات والبيئات التي تم تفعيل ميزة تحقيق الربح فيها، تكون الحصة:
- 70 اتصالاً في الشهر لكل مؤسسة وبيئة للبيانات القياسية.
- 70 مكالمة شهريًا لكل مؤسسة وبيئة للحصول على بيانات تحقيق الربح.
مثلاً، في حال تفعيل ميزة تحقيق الربح في مؤسسة
prod
، يمكنك طلب 70 طلبًا من واجهة برمجة التطبيقات للبيانات العادية و70 طلبًا إضافيًا من واجهة برمجة التطبيقات لبيانات تحقيق الربح.
إذا تجاوزت حصة المكالمات، ستعرض واجهة برمجة التطبيقات استجابة HTTP 429.
عرض حالة جميع طلبات تصدير الإحصاءات
للاطّلاع على حالة جميع طلبات تصدير الإحصاءات، يمكنك إصدار طلب GET
إلى
/analytics/exports
.
على سبيل المثال، يعرض الطلب التالي حالة جميع طلبات تصدير "إحصاءات Google" لبيئة test
في مؤسسة myorg
:
curl -X GET \ "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \ -u email:password
يقدم ما يلي مثالاً على الرد الذي يسرد طلبَي تصدير، أحدهما في قائمة الانتظار (تم إنشاؤه وفي قائمة الانتظار) والآخر مكتمل:
[
{
"self":
"/v1/organizations/myorg/environments/test/analytics/exports/e8b8db22-fe03-4364-aaf2-6d4f110444ba",
"name": "Export results To Cloud Storage",
"description": "One-time export to Google Cloud Storage",
"userId": "my@email.com",
"datastoreName": "My Cloud Storage data store",
"executionTime": "36 seconds",
"created": "2018-09-28T12:39:35Z",
"updated": "2018-09-28T12:39:42Z",
"state": "enqueued"
},
{
"self":
"/v1/organizations/myorg/environments/test/analytics/exports/9870987089fe03-4364-aaf2-6d4f110444ba"
"name": "Export raw results to BigQuery",
"description": "One-time export to BigQuery",
...
}
]
عرض حالة طلب تصدير الإحصاءات
للاطّلاع على حالة طلب تصدير معيّن لخدمة "إحصاءات Google"، يمكنك إصدار طلب تصدير بيانات GET
إلى
/analytics/exports/{exportId}
،
حيث يكون {exportId}
هو رقم التعريف المرتبط بطلب تصدير "إحصاءات Google".
على سبيل المثال، يعرض الطلب التالي حالة طلب تصدير "إحصاءات Google" الذي يحمل رقم التعريف 4d6d94ad-a33b-4572-8dba-8677c9c4bd98
.
curl -X GET \ "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98" \ -u email:password
يقدم ما يلي مثالاً على الرد:
{
"self":
"/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98",
"name": "Export results To Cloud Storage",
"description": "One-time export to Google Cloud Storage",
"userId": "my@email.com",
"datastoreName": "My Cloud Storage data store",
"executionTime": "36 seconds",
"created": "2018-09-28T12:39:35Z",
"updated": "2018-09-28T12:39:42Z",
"state": "enqueued"
}
إذا لم تعرض عملية تصدير الإحصاءات أي بيانات إحصائية، سيتم ضبط executionTime
على "0 ثانية".
تصدير مرجع خاصيّة الطلب
يوضِّح الجدول التالي السمات التي يمكنك تمريرها في نص الطلب بتنسيق JSON عند تصدير بيانات الإحصاءات.
الموقع | الوصف | مطلوب؟ |
---|---|---|
description
|
وصف طلب التصدير. | لا |
name
|
اسم طلب التصدير | نعم |
dateRange
|
حدِّد التاريخَين
"dateRange": { "start": "2018-07-29", "end": "2018-07-30" } يمكن أن تمتد القيمة ملاحظة: لضمان تسجيل جميع البيانات من اليوم السابق، قد تحتاج إلى تأخير وقت بدء طلب التصدير (على سبيل المثال، 00:05:00 صباحًا حسب التوقيت العالمي المنسَّق). |
نعم |
outputFormat
|
حدِّد إما json أو csv .
|
نعم |
csvDelimiter
|
هو المُحدِّد المُستخدَم في ملف إخراج CSV، إذا تم ضبط |
لا |
datastoreName
|
اسم مخزن البيانات الذي يحتوي على تعريف مخزن البيانات الخاص بك. | نعم |
مثلاً:
{
"name": "Export raw results to Cloud Storage",
"description": "Export raw results to Cloud Storage for last 24 hours",
"dateRange": {
"start": "2018-06-08",
"end": "2018-06-09"
},
"outputFormat": "json",
"datastoreName": "My Cloud Storage data repository"
}