تصدير البيانات من "إحصاءات Google"

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. معلومات

إعداد الأذونات لوكلاء الخدمة المحدَّدين

لإعداد الأذونات الخاصة بموظفي الخدمة المعيّنين، استعدادًا للتغييرات الموضّحة أعلاه، يُرجى تنفيذ الخطوات التالية.

1. ابحث عن اسم وكيل خدمة 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"
      },

2. افتح لوحة بيانات إدارة الهوية وإمكانية الوصول في Google Cloud Console.
3. اختَر مشروعك على Google Cloud.
4. انقر على إضافة في أعلى لوحة إدارة الهوية وإمكانية الوصول.
5. في حقل العناصر الرئيسية الجديدة، أدخِل وكيل الخدمة value الذي تم عرضه في الخطوة 1. على سبيل المثال، القيمة value المعروضة في الخطوة 1 هي service-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com.
6. انقر على الزر +إضافة دور آخر وأضِف الأدوار التالية:
   • مستخدم BigQuery
   • مشرف مساحة التخزين
7. انقر على حفظ.

بيانات Apigee Analytics

تنسيق بيانات التصدير

تصدير بيانات الإحصاءات إلى أحد التنسيقات التالية:

• القيم المفصولة بفواصل (CSV)

  المحدِّد الافتراضي هو حرف فاصلة (,). تشمل أحرف المُحدِّد المتوافقة الفاصلة (,) وعلامة الشرطة المستقيمة (|) وعلامة التبويب (\t). اضبط القيمة باستخدام السمة csvDelimiter، كما هو موضَّح في تصدير مرجع خاصية الطلب .

• JSON (محدّد بفواصل جديدة)

  السماح باستخدام حرف السطر الجديد كمحدِّد.

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

يمكنك تصدير بيانات الإحصاءات إلى مستودعات البيانات التالية:

• Google Cloud Storage
• Google BigQuery

نظرة عامة على عملية التصدير

تلخِّص الخطوات التالية العملية المستخدَمة لتصدير بيانات الإحصاءات:

1. اضبط مستودع بياناتك (Cloud Storage أو BigQuery) لتصدير البيانات. يجب التأكد من ضبط مستودع البيانات بشكل صحيح، وأن حساب الخدمة المستخدَم لكتابة البيانات في مستودع البيانات لديه الأذونات الصحيحة.

2. إنشاء مخزن بيانات يحدد خصائص مستودع البيانات (Cloud Storage أو BigQuery) الذي يتم من خلاله تصدير بياناتك، بما في ذلك بيانات الاعتماد المستخدمة للوصول إلى مستودع البيانات.

   عند إنشاء مخزن بيانات، يمكنك تحميل بيانات اعتماد مستودع البيانات إلى Edge Credentials Vault لتخزينها بأمان. بعد ذلك، تستخدم آلية تصدير البيانات بيانات الاعتماد هذه لكتابة البيانات في مستودع البيانات لديك.

3. يمكنك استخدام واجهة برمجة التطبيقات لتصدير البيانات لبدء عملية تصدير البيانات. تعمل عملية تصدير البيانات بشكل غير متزامن في الخلفية.

4. يمكنك استخدام واجهة برمجة التطبيقات لتصدير البيانات لتحديد وقت اكتمال التصدير.

5. عند اكتمال عملية التصدير، اطّلِع على البيانات التي تم تصديرها في مستودع البيانات.

توضح الأقسام التالية هذه الخطوات بمزيد من التفصيل.

تهيئة مستودع البيانات

تعمل آلية تصدير بيانات الإحصاءات على كتابة البيانات إلى 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. راجع تفعيل واجهات برمجة التطبيقات وإيقافها للحصول على التعليمات.

إنشاء مخزن بيانات

لإنشاء مخزن بيانات في واجهة المستخدم:

1. سجِّل الدخول إلى https://apigee.com/edge كمشرف مؤسسة واختَر مؤسستك.

   ملاحظة: يجب أن تكون مشرفًا في مؤسسة Edge حتى تتمكّن من إنشاء مخزن بيانات.

2. اختر المشرف > مخزن بيانات "إحصاءات Google" من شريط التنقّل الأيمن. يتم عرض صفحة مخازن بيانات "إحصاءات Google".

3. انقر على الزر + إضافة مخزن بيانات. سيُطلب منك اختيار نوع مخزن البيانات:

   

4. اختر نوع استهداف بيانات التصدير:

   • Google Cloud Storage
   • Google BigQuery

   تظهر صفحة الضبط:

   

5. أدخِل اسم مخزن البيانات.

6. اختيار بيانات الاعتماد المستخدَمة للوصول إلى مستودع البيانات تظهر قائمة منسدلة ببيانات الاعتماد المتاحة.

   وتكون بيانات الاعتماد خاصة بنوع مستودع بيانات. يُرجى الاطِّلاع على إنشاء حساب خدمة لكل من Cloud Storage أو BigQuery للتعرُّف على المزيد من المعلومات.

   • إذا سبق لك تحميل بيانات الاعتماد، اختَر بيانات الاعتماد من القائمة المنسدلة. تأكد من تحديد بيانات الاعتماد المناسبة لنوع مستودع البيانات.

   • إذا كنت تضيف بيانات اعتماد جديدة إلى مخزن البيانات، اختَر إضافة بيانات اعتماد جديدة. في مربّع الحوار، أدخِل ما يلي:

     1. اسم بيانات الاعتماد
     2. محتوى بيانات الاعتماد هو مفتاح حساب خدمة JSON الخاص بمستودع البيانات كما هو محدَّد في إنشاء حساب خدمة لـ Cloud Storage أو BigQuery.
     3. انقر على إنشاء.

7. أدخِل السمات الخاصة بنوع مستودع البيانات:

   • بالنسبة إلى 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.	نعم

8. اختر اختبار الاتصال للتأكد من إمكانية استخدام بيانات الاعتماد للوصول إلى مستودع البيانات.

   إذا كان الاختبار ناجحًا، احفظ مخزن البيانات.

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

9. بعد اجتياز اختبار الاتصال، احفظ مخزن البيانات.

تعديل مخزن بيانات

لتعديل مخزن بيانات:

1. سجِّل الدخول إلى https://apigee.com/edge كمشرف مؤسسة واختَر مؤسستك.

2. اختر المشرف > مخزن بيانات "إحصاءات Google" من شريط التنقّل الأيمن. يتم عرض صفحة مخازن بيانات "إحصاءات Google".

3. حرِّك مؤشر الماوس فوق عمود التعديل في التقرير المطلوب تعديله. يظهر رمز تعديل وحذف.

4. تعديل مخزن البيانات أو حذفه

5. إذا عدّلت مخزن البيانات، اختر اختبار الاتصال للتأكد من إمكانية استخدام بيانات الاعتماد للوصول إلى مخزن البيانات.

   إذا كان الاختبار ناجحًا، يمكنك عرض نموذج البيانات في مستودع البيانات.

   إذا تعذّر الاختبار، أصلِح أي مشاكل ثم أعِد محاولة الاختبار.

6. بعد اجتياز اختبار الاتصال، عدِّل مخزن البيانات.

تصدير بيانات الإحصاءات

لتصدير بيانات الإحصاءات، يمكنك إصدار طلب 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 عند تصدير بيانات الإحصاءات.

"dateRange": {
    "start": "2018-07-29",
    "end": "2018-07-30"
}

مثلاً:

{
    "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"
  }