تصدير البيانات من "إحصاءات 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

يستخدم 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 ساعة من بيئة الاختبار في مؤسسة 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

استخدِم معرّف الموارد المنتظم (URI) المحدَّد في السمة self لتتبُّع حالة المهمة كما هو موضّح في عرض حالة طلب تصدير الإحصاءات.

المثال 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>

استخدِم معرّف الموارد المنتظم (URI) المحدَّد في السمة 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.

على سبيل المثال، يعرض الطلب التالي حالة جميع طلبات تصدير الإحصاءات لبيئة 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",
    ... 
  }
]

عرض حالة طلب تصدير الإحصاءات

للاطّلاع على حالة طلب تصدير معيّن للإحصاءات، يمكنك إرسال طلب GET إلى /analytics/exports/{exportId}، حيث يكون {exportId} هو رقم التعريف المرتبط بطلب تصدير الإحصاءات.

على سبيل المثال، يعرض الطلب التالي حالة طلب تصدير الإحصاءات برقم التعريف 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"
  }