- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- MetricsGranularity
- MetricsFilter
- MetricsValue
- جرِّبه الآن
يمكنك الحصول على بيانات المقاييس للنصوص البرمجية، مثل عدد عمليات التنفيذ والمستخدمين النشطين.
طلب HTTP
GET https://script.googleapis.com/v1/projects/{scriptId}/metrics
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
scriptId |
حقل مطلوب يشير إلى النص البرمجي المطلوب الحصول على مقاييس له |
معلمات طلب البحث
المَعلمات | |
---|---|
metricsGranularity |
حقل مطلوب يشير إلى دقة المقاييس المعروضة. |
metricsFilter |
حقل اختياري يحتوي على فلاتر لتطبيقها على الطلب وهذا يحد من نطاق المقاييس المعروضة إلى تلك المحدّدة في الفلتر. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
مورد يحتوي على إحصاءات استخدام لنص برمجي معيَّن، استنادًا إلى الفلتر والقناع المقدمين في الطلب.
تمثيل JSON |
---|
{ "activeUsers": [ { object ( |
الحقول | |
---|---|
activeUsers[] |
عدد المستخدمين النشطين. |
totalExecutions[] |
إجمالي عدد عمليات التنفيذ. |
failedExecutions[] |
عدد عمليات التنفيذ التي تعذّر تنفيذها |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/script.metrics
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
MetricsGranularity
دقة المقياس المطلوب عرض بيانات له.
عمليات التعداد | |
---|---|
UNSPECIFIED_GRANULARITY |
دقة المقاييس التلقائية المستخدَمة لطلب البحث عن أي مقاييس |
WEEKLY |
يمثّل المقاييس الأسبوعية. |
DAILY |
يمثل المقاييس اليومية خلال فترة 7 أيام. |
MetricsFilter
الفلتر المستخدَم لتقليل نطاق الطلب.
تمثيل JSON |
---|
{ "deploymentId": string } |
الحقول | |
---|---|
deploymentId |
حقل اختياري يشير إلى عملية نشر معيّنة لاسترداد المقاييس منها. |
MetricsValue
قيمة المقاييس التي تحتفظ بعدد عمليات التنفيذ التي يتم احتسابها.
تمثيل JSON |
---|
{ "value": string, "startTime": string, "endTime": string } |
الحقول | |
---|---|
value |
تشير إلى عدد عمليات التنفيذ التي تم احتسابها. |
startTime |
حقل مطلوب يشير إلى وقت بدء الفاصل الزمني طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
endTime |
حقل مطلوب يشير إلى وقت انتهاء الفاصل الزمني. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |