يوفّر إعداد التقارير في "منصة خرائط Google" مجموعة من العناصر المرئية المحدّدة مسبقًا تقارير استخدام واجهة برمجة التطبيقات الأساسية، والحصة، ومعلومات الفوترة في Google Cloud Console استخدِم هذه التقارير لتحديد عدد واجهات برمجة التطبيقات التي أجريتها، ومدى اقترابك من بلوغ حصص استخدام واجهة برمجة التطبيقات، وراقب استخدام الفوترة بمرور الوقت
تشمل أنواع التقارير ما يلي:
- تقارير الاستخدام: تُبلغ عن عدد الطلبات التي يرسلها مشروعك. واجهات برمجة التطبيقات في Google Maps Platform باستخدام بيانات الاعتماد المرتبطة بمشروعك.
- تقارير الحصص: يتم استخدام حصة التقارير في الرسوم البيانية التي يمكن تجميعها في الطلبات في الدقيقة. يتم عرض حدود الحصة الحالية لواجهات برمجة التطبيقات المحددة في الجداول أسفل الرسوم البيانية لاستخدام الحصص.
- تقارير الفوترة: تقارير التكاليف بمرور الوقت كرسم بياني خطّي مكدّس. عرض استخدام حصة الشهر الحالي، بما في ذلك أي أرصدة خاصة بالاستخدام تم تطبيقها، بالإضافة إلى إجمالي التكلفة المتوقعة للشهر الحالي بأكمله.
- تقارير التفاعل: تقدِّم إحصاءات عن النشاط التجاري حول كيفية تفاعل المستخدمين مع تطبيقات الخرائط.
للحصول على قائمة كاملة بحالات الاستجابة ورموز الاستجابة التي تحدد وما إذا كان الطلب يظهر في أقسام الاستخدام والحصة و/أو الفوترة، يمكنك الاطّلاع على حالة الردّ والتقارير:
يمكنك عرض تقارير استخدام "منصة خرائط Google" وحصتها وفواتيرها باستخدام Cloud Console:
تقارير الاستخدام
ويستند الاستخدام إلى عدد الطلبات التي يرسلها مشروعك إلى واجهات برمجة التطبيقات في Google Maps Platform باستخدام بيانات الاعتماد المرتبطة مشروعك. تشمل الطلبات الطلبات الناجحة والطلبات الناتجة عن وجود خادم والطلبات والطلبات التي تؤدي إلى حدوث أخطاء في العميل. تشمل المؤهلات مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء (للخطة المميّزة ومشاريع الخطة المميّزة التي تم نقل بياناتها) لمعرفة التفاصيل، يُرجى الاطّلاع على نظرة عامة على الخطة المميّزة و معلومات حول استخدام معرِّف عميل.
يتم عرض مقاييس الاستخدام في جداول (الطلبات والأخطاء ووقت الاستجابة) والرسوم البيانية (حركة المرور، والأخطاء، ووقت الاستجابة). لأغراض التتبع:
جميع واجهات برمجة التطبيقات: يمكنك فلترة مقاييس الاستخدام وتجميعها لجميع واجهات برمجة التطبيقات في هذه الطرق:
- الفلترة حسب الفترة الزمنية وواجهة برمجة التطبيقات
- الاطّلاع على عدد الزيارات والأخطاء ووقت الاستجابة مجمّعة حسب رمز الاستجابة وواجهة برمجة التطبيقات بيانات اعتمادك.
واجهة برمجة تطبيقات معيّنة: يمكنك فلترة مقاييس الاستخدام وتجميعها لواجهة برمجة تطبيقات معيّنة. بإحدى الطرق التالية:
- الفلترة حسب الفترة الزمنية وإصدارات واجهة برمجة التطبيقات وبيانات الاعتماد والطرق
- الاطّلاع على عدد الزيارات والأخطاء ووقت الاستجابة مجمّعة حسب رمز الاستجابة وطريقة واجهة برمجة التطبيقات والإصدار وبيانات الاعتماد.
واجهات برمجة التطبيقات صفحة "لوحة بيانات الخدمات"
واجهات برمجة التطبيقات خدمات لوحة البيانات نظرة عامة على مقاييس الاستخدام لجميع واجهات برمجة التطبيقات لمشروعك: واجهات برمجة التطبيقات لنظام خرائط Google بالإضافة إلى واجهات برمجة التطبيقات والخدمات.
تعرض صفحة لوحة البيانات ثلاثة رسومات بيانية وجدولاً. يمكنك فلترة بيانات الاستخدام المعروضة في الرسومات البيانية والجداول من خلال تحديد فترة زمنية من ساعة واحدة حتى آخر 30 يومًا
يوضّح الرسم البياني عدد الزيارات الاستخدام في طلبات البحث في الدقيقة لكل واجهة برمجة تطبيقات.
يعرض الرسم البياني للأخطاء النسبة المئوية للطلبات التي أدّت إلى حدوث أخطاء. لكل واجهة برمجة تطبيقات.
يعرض الرسم البياني لوقت الاستجابة متوسط وقت الاستجابة للطلبات لكل واجهة برمجة تطبيقات.
أسفل الرسومات البيانية، يظهر جدول يدرج واجهات برمجة التطبيقات والخدمات المفعَّلة. الطلبات هي عدد الطلبات (للفترة الزمنية المحددة). تشير الأخطاء إلى عدد هذه الطلبات التي أدّت إلى حدوث أخطاء. وقت الاستجابة (وقت الاستجابة المتوسط والشريحة المئوية) هو وقت الاستجابة لهذه الطلبات.
للوصول إلى واجهات برمجة التطبيقات صفحة لوحة بيانات الخدمات:
- افتح صفحة "أداة اختيار المشاريع" في Cloud Console:
- اختَر مشروعك. واجهات برمجة التطبيقات ستظهر صفحة "لوحة بيانات الخدمات".
إذا لم تظهر الصفحة، انقر على زر القائمةثم حدد واجهات برمجة التطبيقات الخدمات:
لمزيد من المعلومات، راجِع مراقبة استخدام واجهة برمجة التطبيقات.
صفحة النظرة العامة على "خرائط Google"
خرائط Google صفحة نظرة عامة جدول يسرد واجهات برمجة التطبيقات المفعّلة وطلبات الاستخدام في آخر 30 يومًا. يتم أيضًا عرض الطلبات بحسب واجهة برمجة التطبيقات في شكل رسم بياني. يعرض الرسم البياني للفوترة فاتورتك الحالية. وإجمالي الاستخدام خلال آخر 3 أشهر.
للوصول إلى صفحة النظرة العامة على "منصة خرائط Google":
- افتح صفحة "منصة خرائط Google" في Cloud Console:
- انقر على نظرة عامة في القائمة اليمنى.
واجهات Google Maps Platform API صفحة الخدمات
خرائط Google واجهات برمجة التطبيقات صفحة الخدمات يحتوي على شبكة من المربّعات التي تمثّل واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) والخدمات الأخرى. المتاحة لمشروعك. في كل مربّع، يمكنك تفعيل ذلك أو إيقافه عن طريق تحديد تفعيل أو إيقاف، ويمكنك الوصول إلى بيانات الاعتماد والمعلومات والمقاييس وأدلة المستخدم من واجهات برمجة التطبيقات الممكنة. يمكنك أيضًا استخدام فلاتر الصفحات لعرض الخدمات المفعَّلة أو غير المفعَّلة وفئات الخدمات الأخرى
للوصول إلى واجهات برمجة التطبيقات في Google Maps Platform صفحة الخدمات:
- افتح صفحة "منصة خرائط Google" في Cloud Console:
- في القائمة اليمنى، حدد واجهات برمجة التطبيقات الخدمات:
صفحة "مقاييس خرائط Google"
خرائط Google صفحة المقاييس ثلاثة رسومات بيانية: عدد الزيارات والأخطاء وزمن الانتقال المتوسط. يمكن تجميع بيانات الاستخدام في الرسوم البيانية حسب فئة رمز الاستجابة وواجهة برمجة التطبيقات وطريقة واجهة برمجة التطبيقات وبيانات الاعتماد والنظام الأساسي والنطاق.
أسفل الرسومات البيانية، تتضمّن صفحة المقاييس جدولاً لواجهات برمجة التطبيقات يعرض. والطلبات والأخطاء ووقت الاستجابة لواجهات برمجة التطبيقات التي اخترتها.
باستخدام القائمة المنسدلة لواجهة برمجة التطبيقات في الأعلى، وخيارات التجميع والتصفية في الجزء الأيسر، يمكنك تجميع مقاييس الاستخدام المعروضة وتصفيتها عن طريق تحديد واجهات برمجة تطبيقات محددة أو متعددة، بيانات الاعتماد و/أو فئات رمز الاستجابة و/أو نوع النظام الأساسي و/أو النطاق. يمكنك أيضًا اختيار فترة زمنية (من ساعة واحدة إلى آخر 30 يومًا) ودرجة الدقة (في الثانية أو اليوم) لمقاييس الاستخدام المعروضة.
تعرض الصور التالية فلترَي النظام الأساسي والنطاق لواجهة برمجة تطبيقات واحدة في حال: يتم اختيار التجميع حسب النظام الأساسي والنطاق في القائمة المنسدلة التجميع حسب:
للوصول إلى صفحة مقاييس واجهة برمجة التطبيقات في "منصة خرائط Google":
- افتح صفحة "منصة خرائط Google" في Cloud Console:
- انقر على المقاييس في القائمة اليمنى.
إعداد تقارير بيانات الاعتماد
يمكنك تصفية المقاييس وتجميعها حسب بيانات الاعتماد التي تم استخدامها لتحميل واجهة برمجة التطبيقات.
تنسيق بيانات الاعتماد | المعنى |
---|---|
اسم المفتاح على سبيل المثال، "مفتاح تطبيق للأجهزة الجوّالة" |
تم استخدام مفتاح واجهة برمجة تطبيقات لتحميل واجهة برمجة التطبيقات باستخدام
?key=... : يمكنك العثور على أسماء المفاتيح على "منصة خرائط Google"
ضمن Keys & (المفاتيح) بيانات الاعتماد: |
رقم المشروع على سبيل المثال، "project_number:123456"، حيث يكون 123456 هو رقم مشروعك. |
هناك احتمالان إذا رأيت بيانات الاعتماد هذه:
|
الرسوم البيانية لرموز الاستجابة
يتم تقسيم الرسمين البيانيين عدد الزيارات حسب رمز الاستجابة والخطأ حسب رمز الاستجابة. استخدامه لفئة رمز استجابة HTTP. يوضح هذا الجدول التعيين بين حالة الاستجابة لواجهة برمجة التطبيقات في Google Maps Platform وفئة رمز استجابة HTTP:
حالة واجهة برمجة التطبيقات للخرائط | فئة رمز استجابة HTTP - تقرير الاستخدام (2xx، 3xx، 4xx، 5xx) |
ملاحظات |
---|---|---|
حسنًا | 2xx | تمت الاستجابة بنجاح. هذا طلب قابل للفوترة، وسيستهلك حصة. |
حسنًا | 3xx | تمت الاستجابة بنجاح. هذا طلب قابل للفوترة، وسيستهلك حصة. على سبيل المثال، صورة المكان الطلبات الناجحة بإرجاع إعادة التوجيه 302 إلى الصورة المشار إليها. |
DATA_NOT_AVAILABLE | 4xx(1) | استجابة ناجحة تشير إلى عدم توفر بيانات
مواقع الإدخال. هذا طلب قابل للفوترة، وسيستهلك حصة. |
ZERO_RESULTS | 4xx(1) | لم تعرض الاستجابة الناجحة أي نتائج. هذا طلب قابل للفوترة، وسيستهلك حصة. |
NOT_FOUND | 4xx(1) | بالنسبة إلى
Directions API
تشير هذه الرسالة إلى أن أحد المواقع المحددة على الأقل
تعذّر ترميز مصدر الطلب أو وجهته أو نقاط المسار جغرافيًا. بالنسبة إلى واجهة برمجة تطبيقات الأماكن تشير هذه الرسالة إلى أن الموقع المشار إليه (place_id) لم يكن في قاعدة بيانات الأماكن. هذا طلب قابل للفوترة، وسيستهلك حصة. |
nofollow_REQUEST (قيمة مَعلمة غير صالحة)، MAX_WAYPOINTS_EXCEEDED، MAX_ROUTE_LENGTH_EXCEEDED وغير ذلك. |
4xx | حدث خطأ ناتج عن قيمة معلَمة غير صالحة. التحقّق من واجهة برمجة التطبيقات
لمزيد من التفاصيل. هذا طلب قابل للفوترة، وسيستهلك حصة. |
REQUEST_DENIED | 4xx | خطأ في العميل تسبّب في حدوث خطأ في المصادقة وخطأ في الوصول وغير ذلك. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات. |
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، RI_EXHAUSTED، تم تجاوز حد المعدل، تم تجاوز الحد اليومي المسموح به، userRateLimitExceeded |
4xx | حدث خطأ في العميل نتيجة وجود عدد كبير جدًا من الطلبات خلال فترة زمنية مسموح بها. إعادة المحاولة الطلب في وقت لاحق. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات. |
UTF_REQUEST (معلمة غير صالحة أو مفقودة، طلب غير صالح خطأ في التحليل أو في التحقق من الصحة) | 4xx | حدث خطأ في العميل نتيجة طلب غير صالح. يمكنك الاطّلاع على استجابة واجهة برمجة التطبيقات لمزيد من المعلومات. التفاصيل. |
NOT_FOUND (404) | 4xx | بالنسبة إلى
Geolocation API
تشير هذه الرسالة إلى أن المدخلات لم تكن كافية لإنتاج
تقدير الموقع. بالنسبة إلى Roads API، تشير هذه الرسالة إلى أنه لا يمكن استخلاص المدخلات بشكل معقول إلى الطرق. هذا طلب قابل للفوترة، وسيستهلك حصة. |
UNKNOWN_ERROR | 5xx | خطأ في الخادم يشير إلى تعذُّر متابعة الطلب: داخلي خطأ، أو تحميل زائد، أو غير متاح، أو انتهاء المهلة، و غير ذلك. |
1
لتحسين اتساق إعداد تقارير رموز الخطأ، استخدمت "منصة خرائط Google"
يتم نقل بيانات واجهات برمجة التطبيقات:
1) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة إلى
حالات واجهة برمجة التطبيقات للخرائط: DATA_NOT_AVAILABLE وNOT_FOUND
ZERO_RESULTS - الحالة،
2) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة
حالات واجهة برمجة التطبيقات للخرائط: REQUEST_DENIED ، OVER_DAILY_LIMIT ،
OVER_QUERY_LIMIT ، dailyLimitExceeded ،
rateLimitExceeded ، userRateLimitExceeded ،
3) من فئة رمز استجابة HTTP 2xx إلى 5xx
حالة واجهة برمجة التطبيقات للخرائط: UNKNOWN_ERROR .
يمكنك الاطّلاع على رمزَي الاستجابة أثناء عملية النقل.
الفترة. لن تتغير رموز الاستجابة التي يتم عرضها في الردود من واجهة برمجة التطبيقات للخرائط.
تأكَّد من أنّ الزيادة في 4xx و/أو 5xx في
مقاييس "منصة خرائط Google"
يرتبط بعملية النقل هذه من خلال التحقق من رمز الاستجابة الدقيقة الذي يزيد في
مستكشف المقاييس
(مزيد من المعلومات حول استخدام
مراقبة السحابة الإلكترونية من Google لمنصة خرائط Google).
|
لمزيد من المعلومات حول رموز الحالة ورسائل الخطأ، يمكنك الاطّلاع على الرد مستندات خاصة بواجهة برمجة التطبيقات التي تهمّك (على سبيل المثال، الاستجابات الخاصة بالترميز الجغرافي أو الردود المتعلقة بالاتجاهات).
مَعلمات حلول "منصة خرائط Google"
توفر "منصة خرائط Google" العديد من أنواع الرموز النموذجية لمساعدتك على النهوض والعمل بسرعة. على سبيل المثال، يمكنك استخدام أداة إنشاء سريعة في Cloud Console، اتّبِع الحلول المتخصّصة في المجال أدلة التنفيذ والتعلم من الدروس التطبيقية حول الترميز
لفهم طريقة الاستخدام وطُرق تحسين الحلول التي نقدّمها، تضمّ Google
مَعلمة طلب بحث واحدة (solution_channel
)
في طلبات بيانات من واجهة برمجة التطبيقات لجمع معلومات عن استخدام نموذج الرمز:
- يتم تضمين معلَمة طلب البحث
solution_channel
تلقائيًا في نموذج التعليمات البرمجية للحل. - تعرض معلَمة طلب البحث إحصاءات عند استخدام الحل في Google لتحسين جودة الحل في التكرارات المستقبلية.
- يمكنك إيقاف هذه الميزة من خلال حذف طلب البحث
solution_channel
. وقيمتها من نموذج التعليمات البرمجية. - وليس هناك أي متطلبات للاحتفاظ بالمَعلمة. جارٍ إزالة طلب البحث لا تؤثر على الأداء.
- لا تُستخدم معلمة طلب البحث إلا لإعداد تقارير عن استخدام نموذج الرمز.
- وتكون معلمة طلب البحث منفصلة عن أي إحصاءات أو إحصاءات خاصة بواجهة برمجة التطبيقات الإعلام. يعني ذلك إزالة المَعلمة من رمز نموذج الحل. لا يؤدي إلى إيقاف إعداد تقارير واجهة برمجة تطبيقات JavaScript للخرائط الداخلية.
تقارير الحصص
تضع الحصص حدودًا على عدد الطلبات التي يمكن لمشروعك تقديمها إلى واجهات Google Maps Platform API. يمكن وضع حدود على الطلبات من خلال ثلاث طرق: في اليوم وفي الدقيقة ولكل مستخدم في الدقيقة. الطلبات الناجحة فقط يتم احتساب الطلبات التي تتسبب في حدوث أخطاء في الخادم ضمن الحصة. الطلبات التي عند إخفاق المصادقة، لا يتم احتسابه من الحصة.
يتم عرض مقدار استخدام الحصة في رسوم بيانية في صفحة الحصص في Cloud Console، ويمكن تجميعها في الطلبات في الدقيقة. حدود الحصة الحالية يتم عرض واجهات برمجة التطبيقات المحددة في جداول أسفل نسبة استخدام الحصة والرسوم البيانية.
لمعرفة قيمة الحصة في الدقيقة لأي منتج من منتجات واجهة برمجة التطبيقات في "منصة Google للتسويق"، استخدِم هذا الآلة الحاسبة.
صفحة الحصص في "خرائط Google"
خرائط Google صفحة الحصص تعرض حدود الحصص واستهلاك الحصص لواجهة برمجة التطبيقات التي اخترتها.
يعرض الرسم البياني لاستخدام الحصة في Google Cloud Console إجمالي عدد الزيارات إلى مفاتيح واجهة برمجة التطبيقات ومعرفات العملاء. تتوفر زيارات معرِّف العميل أيضًا في رسم بياني للمقاييس على Cloud Console
لا تعرض الصفحة سوى الطلبات التي تستهلك حصة: الطلبات الناجحة (OK
،
ZERO_RESULTS
وDATA_NOT_AVAILABLE
) والطلبات التي تتسبب في حدوث أخطاء في الخادم
(NOT_FOUND
، INVALID_REQUEST/INVALID_VALUE
(قيمة مَعلمة غير صالحة)، UNKNOWN_ERROR
).
الطلبات التي تتسبب في أخطاء العميل، مثل المصادقة والتفويض
أخطاء وسيطات غير صالحة (REQUEST_DENIED
، OVER_QUERY_LIMIT
، INVALID_REQUEST
(مَعلمة غير صالحة، خطأ في تحليل الطلب)
— لا تستهلك حصة ولا يتم عرضها.
وحدة الحصة هي طلب لمعظم واجهات برمجة تطبيقات "منصة خرائط Google". (واجهة برمجة التطبيقات الثابتة للخرائط وواجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" وGeocoding API وDirects API Places API وTime Zone API Geolocation API وGeolocation API) ولكن هناك بعض الاستثناءات:
- بالنسبة إلى واجهة برمجة تطبيقات مصفوفة المسافة، تكون وحدة الحصة عبارة عن عنصر وهو زوج المصدر-الوجهة.
- بالنسبة إلى واجهة برمجة تطبيقات JavaScript للخرائط، تكون وحدة الحصة عبارة عن تحميل خريطة.
- بالنسبة إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS تكون وحدة الحصة عبارة عن طلب في التجوّل الافتراضي أو بانوراما التحميل. تتوفّر عمليات تحميل الخرائط بدون أي رسوم ولا تستهلك حصة.
للوصول إلى صفحة "الحصص" في منصة "خرائط Google":
- افتح صفحة "منصة خرائط Google" في Cloud Console:
- في القائمة اليمنى، اختَر الحصص.
- اختَر واجهة برمجة تطبيقات من القائمة المنسدلة لواجهة برمجة التطبيقات.
وحدات الحصة
يعرض هذا الجدول وحدة الحصة لواجهات برمجة التطبيقات في "منصة خرائط Google".
واجهة برمجة التطبيقات على "منصة خرائط Google" | وحدة الحصة |
---|---|
Maps | |
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android | بانوراما واحدة |
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS | بانوراما واحدة |
Map Tiles API | طلب واحد |
واجهة برمجة التطبيقات للعرض الجوي في "خرائط Google" | طلب واحد |
Maps Static API | طلب واحد |
Maps JavaScript API | تحميل خريطة واحد |
Street View Static API | طلب واحد |
Maps Embed API | تحميل خريطة واحد |
المسارات | |
Routes API (حوسبة المسارات) | طلب واحد |
Routes API (Compute Route Matrix) | عنصر واحد (زوج المصدر-الوجهة) |
Directions API | طلب واحد |
Distance Matrix API | عنصر واحد (زوج المصدر-الوجهة) |
Roads API | طلب واحد |
Route Optimization API | طلب واحد |
أماكن | |
واجهة برمجة تطبيقات الأماكن | طلب واحد |
Address Validation API | طلب واحد |
Geocoding API | طلب واحد |
Geolocation API | طلب واحد |
Time Zone API | طلب واحد |
البيئة | |
واجهة برمجة تطبيقات جودة الهواء (CurrentConditions وHeartmapTile) | طلب واحد |
واجهة برمجة تطبيقات جودة الهواء (السجلّ) | صفحة واحدة |
Pollen API | طلب واحد |
Solar API | طلب واحد |
تقارير الفوترة
عرض تقرير الفوترة
تقارير الفوترة لاستخدام منتجات "منصة خرائط Google" هي متاحة في Google Cloud Console لمزيد من المعلومات، يُرجى مراجعة الفوترة:
للوصول إلى تقارير الفوترة:
- افتح صفحة "أداة اختيار المشاريع" في Cloud Console:
- اختَر مشروعًا.
- انقر على زر القائمة
. ثم اختَر الفوترة.
- إذا كانت لديك حسابات فوترة متعددة، اختَر الانتقال إلى حساب الفوترة المرتبط. لفتح صفحة نظرة عامة لحساب الفوترة المرتبط.
- في القائمة اليمنى، انقر على التقارير لفتح صفحة التقارير الخاصة بالفوترة. لحساب الفوترة المرتبط
كيفية قراءة الرسم البياني لتقرير الفوترة
تعرض تقارير الفوترة التكلفة بمرور الوقت كرسم بياني خطّي مكدّس. الإعداد التلقائي عرض التكاليف الخاصة بالاستخدام اليومي للشهر الحالي مجمّعة حسب مشروعك (لكل المنتجات)، بما في ذلك أي أرصدة خاصة بالاستخدام تم تطبيقها بالإضافة إلى إجمالي التكلفة المتوقعة للشهر الحالي بأكمله. على كل الخط في المخطط (والصف في جدول الملخص) مع المشروع، مرتبة من الأكبر إلى الأصغر حسب التكلفة. مزيد من المعلومات حول تفسير الرسم البياني لتقرير الفوترة
![لقطة شاشة لتقرير الفوترة يعرضان رسمًا بيانيًا وجدولاً باستخدام
العرض التلقائي للإعداد المسبق](https://cloud.google.com/billing/docs/images/billing-reports1.png?authuser=19&hl=ar)
نصيحة: تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي
لفهم تفاصيل نموذج تسعير الدفع حسب الاستخدام بدقة أكبر ومدى تأثيره في عملية التنفيذ، واطّلِع على الاستخدام والتكلفة حسب رمز التخزين التعريفي
![تقرير الفوترة مجمّع حسب رمز التخزين التعريفي](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-table-by-sku.png?authuser=19&hl=ar)
![لقطة شاشة لفلاتر تقارير الفوترة](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-filters-sku.png?authuser=19&hl=ar)
لتغيير طريقة عرض التقارير إلى عرض العناصر حسب رمز التخزين التعريفي:
- في اللوحة على يسار الرسم البياني، وسِّع الفلتر التجميع حسب.
- اختَر رمز التخزين التعريفي.
تشمل فلاتر تقارير الفوترة الأخرى المتاحة النطاق الزمني والمشاريع المنتجات ورموز التخزين التعريفية والمواقع الجغرافية التي تتيح لك الفلترة حسب أين التي يتم عرض طلبات البيانات من واجهة برمجة التطبيقات منها.
لتصنيف مصدر الاستخدام بالإضافة إلى الفوترة الجماعية للمنتج التقارير حسب إحدى القيم المدرجة. المفاتيح الثلاثة التي تتعلق واجهات برمجة التطبيقات في Google Maps Platform هي goog-maps-api-key-suffix (الأربع الأخيرة مفتاح واجهة برمجة التطبيقات)، goog-maps-platform-type (النظام الأساسي: Android، iOS أو JavaScript أو webservice) وgoog-maps-channel (مجموعة رقمية قيمة القناة من طلب بحث في واجهة برمجة التطبيقات). المزيد معلومات حول الفلترة والتجميع.
يمكنك تغيير عرض الرسم البياني لاستبعاد الأرصدة الخاصة بالاستخدام عن طريق محو مربّع الاختيار تضمين الأرصدة في التكلفة في اللوحة اليسرى.
مراقبة الاستهلاك وحظره
لمساعدتك في التخطيط لميزانيتك والتحكم في التكاليف، يمكنك إجراء ما يلي:
- إعداد تنبيه بشأن الميزانية لتتبّع كيفية نمو إنفاقك إلى مبلغ معين. وضع الميزانية لا تحد من استخدام واجهة برمجة التطبيقات، بل تنبهك فقط عند اقتراب مبلغ إنفاقك من المبلغ المحدد.
تحديد الاستخدام اليومي لواجهة برمجة التطبيقات، لإدارة تكلفة استخدام واجهات برمجة التطبيقات القابلة للفوترة. من خلال وضع حدود قصوى لـ الطلبات لكل اليوم، يمكنك الحدّ من إنفاقك. استخدِم معادلة بسيطة لتحديد جدول مواعيدك اعتمادًا على المبلغ الذي تريد إنفاقه. مثل: (الإنفاق الشهري /السعر لكل رمز تخزين تعريفي)/30 = الحدّ الأقصى لعدد الطلبات في اليوم (لواجهة برمجة تطبيقات واحدة).
تتبُّع الاستخدام لكل قناة
لتتبع استخدامك عبر القنوات الرقمية، يجب إضافة "channel" مَعلمة إلى طلبات البيانات من واجهة برمجة التطبيقات يُرجى العلم أنّ قيم القناة الوحيدة المقبولة هي الأرقام من 0 إلى 999. وفي ما يلي بعض الأمثلة على ذلك:
- واجهة برمجة تطبيقات Geocoding Web Service API
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
- واجهة برمجة تطبيقات JavaScript للخرائط
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
يمكنك مراقبة استخدام القناة مباشرةً في تقرير الفوترة. ستعكس القنوات ضمن التصنيفات باعتبارها goog-maps-channel رئيسية.
![الفلترة حسب التصنيفات](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-filter-channel.png?authuser=19&hl=ar)
لفلترة تقرير الفوترة حسب رمز التخزين التعريفي والقناة
- استخدِم فلتر رمز التخزين التعريفي التجميع حسب.
- اختَر علامة إقحام التصنيفات.
- اختر القائمة المنسدلة المفتاح واختر goog-maps-channel.
- انقر على القائمة المنسدلة القيمة واختَر القنوات الرقمية التي تريد فلترتها.
يمكنك التجميع حسب مفتاح التصنيف goog-maps-channel للاطّلاع على التكلفة الناتجة عن كل قناة.
بعد تضمين بيانات استخدام القناة في طلباتك، قد يحدث تأخير قصير (حتى 24 ساعة) قبل ظهور البيانات في تقرير الفوترة.
تصدير بيانات الفوترة باستخدام BigQuery
يمكنك أيضًا تصدير بيانات الفوترة إلى BigQuery
تتيح لك BigQuery Export تصدير بيانات تفصيلية عن فوترة Cloud (مثل بيانات الاستخدام تقديرات التكلفة) تلقائيًا على مدار اليوم إلى مجموعة بيانات BigQuery التي تحدّدها. بعد ذلك، يمكنك الوصول إلى بيانات الفوترة من BigQuery لإجراء تحليل تفصيلي. وهذا يوفر طبقة إضافية من الدقة لفهم مصدر استخدامك لـ "منصة خرائط Google".
إذا كنت تريد البدء في عمليات تصدير BigQuery وإجراء طلبات بحث عن البيانات، يمكنك تجربة نموذج طلب البحث أدناه. قبل تشغيل هذا الاستعلام، يجب عليك:
- تفعيل الفوترة تصدير فوترة BigQuery في حسابك
- تنسيق الجدول هو PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID حيث:
- PROJECT_ID هو معرّف مشروعك الفعلي (على سبيل المثال "my-project-123456").
- DATASET_NAME هو اسم مجموعة البيانات التي أنشأتها (على سبيل المثال، "SampleDataSet").
- BILLING_ACCOUNT_ID هو مرجع لمعرّف حساب الفوترة،
تبدأ بـ "gcp_billing_exportv1"، وتغيير الشُرط (-) إلى الشرطات السفلية (_).
على سبيل المثال، سيصبح رقم تعريف حساب الفوترة 123456-7890AB-CDEF01.
gcp_billing_export_v1_123456_789AB_CDEF01
#standardSQL
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day,
invoice.month AS invoice_month,
service.description AS service,
sku.description AS sku,
(
SELECT l.value
FROM Unnest(labels) AS l
WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
Round(Sum(usage.amount), 2) AS usage_amount,
usage.unit AS usage_unit,
Round(Sum(cost), 2) AS cost,
cost_type,
currency
FROM PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
WHERE invoice.month = '202002' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
invoice_month,
service,
sku,
goog_maps_channel,
usage_unit,
cost_type,
currency
ORDER BY billing_day,
service,
sku
مراجع ذات صلة
الفوترة في السحابة الإلكترونية:
- إنشاء حساب فوترة في Cloud أو تعديله أو إغلاقه
- تعديل إعدادات الفوترة لمشروع
- الاطّلاع على تقارير الفوترة ومؤشرات التكلفة
- ضبط الميزانيات وتنبيهات الميزانية
- تحديد استخدام واجهة برمجة التطبيقات
حالة الردّ والتقارير
يعرض الجدول أدناه التعيين بين حالة واجهة برمجة تطبيقات الخرائط ورمز استجابة HTTP التي تم إرجاعها في ردود واجهة برمجة التطبيقات للخرائط وفئة رمز استجابة HTTP في تقرير الاستخدام، وتشير إلى إذا ظهر الطلب المقابل في تقارير "الاستخدام" و"الحصة" و"الفوترة".
تقرير الاستخدام في مقاييس منصة "خرائط Google"
تقديم درجة الدقة HTTP response code class
إذا كنت بحاجة إلى مستوى أعلى من
ودقّة التفاصيل، يمكنك الاطّلاع على رموز حالة الردّ.
متاح في
مراقبة استخدام "منصة خرائط Google"
رموز الاستجابة المتاحة في الردود من واجهة برمجة التطبيقات للخرائط | متوفر في تقرير الاستخدام | تم الإبلاغ إلى | |||
---|---|---|---|---|---|
حالة واجهة برمجة التطبيقات للخرائط | رمز استجابة HTTP | فئة رمز استجابة HTTP | الاستخدام | الحصة | الفوترة |
حسنًا | 200، 204، 302 |
2xx، 3xx |
نعم | نعم | نعم |
DATA_NOT_available، NOT_FOUND، ZERO_RESULTS |
200، 404 |
4xx1 | نعم | نعم | نعم |
nofollow_REQUEST (قيمة مَعلمة غير صالحة)، MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED، وهكذا. |
200، 400 |
4xx | نعم | نعم | نعم |
ASCII_REQUEST (معلمة غير صالحة/مفقودة، خطأ في تحليل الطلب) | 200، 400 |
4xx | نعم | لا | لا |
REQUEST_DENIED | 200، 400، 403 |
4xx1 | نعم | لا | لا |
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، RI_EXHAUSTED، تم تجاوز الحد اليومي المسموح به، تم تجاوز الحدّ الأقصى المسموح به لمعدّل الزحف، userRateLimitExceeded |
200، 403، 429 |
4xx1 | نعم | لا | لا |
UNKNOWN_ERROR | 200، 500، 503 |
5xx1 | نعم | نعم | لا |
1
لتحسين اتساق إعداد تقارير رموز الخطأ، استخدمت "منصة خرائط Google"
يتم نقل بيانات واجهات برمجة التطبيقات:
1) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة إلى
حالات واجهة برمجة التطبيقات للخرائط: DATA_NOT_AVAILABLE وNOT_FOUND
ZERO_RESULTS - الحالة،
2) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة
حالات واجهة برمجة التطبيقات للخرائط: REQUEST_DENIED ، OVER_DAILY_LIMIT ،
OVER_QUERY_LIMIT ، dailyLimitExceeded ،
rateLimitExceeded ، userRateLimitExceeded ،
3) من فئة رمز استجابة HTTP 2xx إلى 5xx
حالة واجهة برمجة التطبيقات للخرائط: UNKNOWN_ERROR .
يمكنك الاطّلاع على رمزَي الاستجابة أثناء عملية النقل.
الفترة. لن تتغير رموز الاستجابة التي يتم عرضها في الردود من واجهة برمجة التطبيقات للخرائط.
تأكَّد من أنّ الزيادة في 4xx و/أو 5xx في
مقاييس "منصة خرائط Google"
يرتبط بعملية النقل هذه من خلال التحقق من رمز الاستجابة الدقيقة الذي يزيد في
مستكشف المقاييس
(مزيد من المعلومات حول استخدام
مراقبة السحابة الإلكترونية من Google لمنصة خرائط Google).
|
تقارير التفاعل
إحصاءات النشاط التجاري
تمنحك "منصة خرائط Google" إحصاءات حول كيفية تفاعل المستخدمين مع خرائطك. وتشمل هذه الإحصاءات مقاييس التفاعل الرئيسية، مثل المشاهدات على الخريطة أو التفاعلات مع نقطة اهتمام. ويمكنك تحليل هذه الإحصاءات لرصد المواقع الجغرافية الرائجة للإعلان والتسويق أو لتحسين تجربة المستخدِم.
تشمل إمكانات إعداد تقارير إحصاءات النشاط التجاري ما يلي:
- الاطّلاع على نبذة عامة عن إحصاءات النشاط التجاري لإلقاء نظرة سريعة على المؤشرات الرئيسية في إحصاءات النشاط التجاري
- التوغّل في تحليل مقياس معيّن ضمن وحدة التحكّم لفهم المقاييس بشكل أكثر تفصيلاً
- تصدير المقاييس إلى ملف CSV حتى تتمكّن من تحليل بيانات إحصاءات النشاط التجاري في أداة تحليل الأنشطة التجارية المفضّلة لديك
وتشمل مقاييس التفاعل المتاحة ما يلي:
- طرق عرض الخريطة: تتبع طرق عرض الخريطة الناتجة عن عمليات العرض الشامل أو التكبير/التصغير أو الإمالة. يتم احتساب مشاهدات الخريطة حسب الرمز البريدي على أساس أسبوعي (من الأحد إلى السبت بتوقيت المحيط الهادئ). يتم إصدار البيانات الجديدة أسبوعيًا في أول يوم أربعاء بعد فترة الملاحظة.
يمكن للمستخدمين الاطّلاع على إحصاءات النشاط التجاري في صفحة المقاييس في Cloud Console. يجب أن أن يتم تفعيل واجهة برمجة تطبيقات JavaScript للخرائط.
يمكنك تحليل مقاييس التفاعل مباشرةً في وحدة التحكّم باستخدام ميزتَي "الفلترة" و"التجميع حسب" للاطّلاع على تفاصيل المقاييس بمزيد من التفصيل. على سبيل المثال، قد تختار التصفية حسب منطقة معينة لمعرفة كيف تتجه طرق عرض الخريطة للرموز البريدية فقط في تلك المنطقة. من ناحية أخرى، قد ترغب في التجميع حسب منطقة معينة لتجميع التفاعلات داخل تلك المنطقة.
يمكن للمستخدمين تصدير مجموعة البيانات بالكامل أو طريقة عرض مفلترة إلى ملف CSV لمزيد من التحليل في أداة تحليل الأعمال المفضلة لديك. يمكنك تنزيل ما يصل إلى 90 يومًا في كل مرة وسيتم اقتطاع عمليات التنزيل التي تزيد عن 60 ألف خلية. قد يستغرق تصدير بيانات طرق عرض الخريطة إلى ملف CSV بضع دقائق اعتمادًا على النطاق الزمني المحدّد.
تكون مقاييس "إحصاءات النشاط التجاري" مخفية الهوية، وبالتالي تعكس فقط المؤشرات العامة في التفاعل مع خرائطك. وقد يتم تقريب الأعداد المنخفضة إلى صفر، وقد يتم تقليل المساهمات من القيم الشاذّة.
يمكنك التحكّم في الوصول إلى إحصاءات النشاط التجاري لمشروعك على Google Cloud في Google Cloud Console باستخدام إذن "إحصاءات Google". يُمنح مالكو المشاريع هذا الإذن تلقائيًا ويمكنهم منح إذن الوصول لمستخدمين آخرين حسب الحاجة.
يجب عدم استخدام ميزة "إحصاءات النشاط التجاري" لتقدير تكاليف الاستخدام. يُرجى الرجوع إلى تقارير الاستخدام للحصول على مزيد من المعلومات حول الاستخدام.
أداة البحث عن الأماكن الإضافية
بالنسبة إلى مستخدمي Locator Plus، تساعدك لوحة بيانات الإحصاءات على تحليل وإنشاء إحصاءات مستندة إلى بياناتك، لتقديم صورة واضحة عن مدى جودة المتسوّقين للتفاعل مع محدِّد مواقع المتاجر يمكنك قياس أدائك أسبوعًا بعد أسبوعيًا، بما في ذلك عدد المشاهدات وعدد التفاعلات مع "بحث Google" تفاصيل المكان ونسبة التفاعل الإجمالية. بالإضافة إلى ذلك، تستخدم لوحة المعلومات توفّر مقاييس أداء مهمة مقارنةً بعملية التنفيذ وبائعي تجزئة آخرين.
- الانتقال إلى Locator Plus في Google Cloud Console.
- انتقِل إلى قسم تقارير التفاعل في Google Cloud Console. لعرض لوحة بيانات الإحصاءات
يتيح لك تقرير قياس الأداء مقارنة بياناتك بالبيانات المجمّعة بيانات الصناعة من الشركات الأخرى التي تشارك بياناتها. المقارنة وتوفر سياقًا قيّمًا، مما يساعدك على تحديد أهداف مفيدة، نظرة ثاقبة حول اتجاهات المجال، ومعرفة مستوى أدائك مقارنةً منافسيك.
للاطّلاع على بيانات قياس الأداء، يتم تضمين بيانات تفاعلك بدون الكشف عن هويتك في مقاييس الأداء من Google. لإيقاف كل من عرض وتضمين مشاركة البيانات بشكل مجهول في تقارير قياس الأداء، طلب دعم. سيتم حلّ طلب الدعم بشكل عام في غضون 3 أيام.