- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- إحصاءات BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- التاريخ
تعرض إحصاءات مكالمات النشاط التجاري لموقع جغرافي.
طلب HTTP
GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. الموقع الجغرافي الرئيسي لجلب إحصاءات المكالمات له. التنسيق: المواقع الجغرافية/{locationId} |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
اختياريّ. الحد الأقصى لعدد إحصاءات BusinessCallsInsights المطلوب عرضها. إذا لم يتم تحديد ذلك، سيتم إرجاع 20 طلب كحد أقصى. تعرض بعض أنواع المقاييس(مثل AGGREGATE_COUNT) صفحة واحدة. وبالنسبة إلى هذه المقاييس، يتم تجاهل pageSize. |
pageToken |
اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى |
filter |
اختياريّ. فلتر يقيّد ظهور إحصاءات المكالمات. لا يتضمن الرد سوى الإدخالات التي تتطابق مع الفلتر. إذا لم يتم توفير MetricType، فسيتم عرض AGGREGATE_COUNT. في حال عدم تقديم تاريخ انتهاء، سيتم استخدام آخر تاريخ تتوفّر فيه البيانات. وفي حال عدم تقديم تاريخ البدء، سيتم تلقائيًا تحديد التاريخ الأول الذي تتوفّر له البيانات، وهو حاليًا 6 أشهر. إذا كان تاريخ البدء قبل تاريخ توفُّر البيانات، يتم عرض البيانات بدءًا من تاريخ توفُّرها. في الوقت الحالي، نتيح استخدام الفلاتر التالية. 1. startDate="DATE" حيث التاريخ بتنسيق YYYY-MM-DD. 2. endDate="DATE" حيث التاريخ بتنسيق YYYY-MM-DD. 3- MetricsType=XYZ حيث تكون XYZ هي MetricType صالح. 4. الاقتران(و) لكل ما سبق. على سبيل المثال، "startDate=2021-08-01 AND endDate=2021-08-10 ANDmetricType=AGGREGATE_COUNT" يتجاهل AGGREGATE_COUNTmetricType الجزء DD من التاريخ. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ على businesscallsinsights.list.
تمثيل JSON |
---|
{
"businessCallsInsights": [
{
object ( |
الحقول | |
---|---|
businessCallsInsights[] |
مجموعة من إحصاءات مكالمات النشاط التجاري للموقع الجغرافي. |
nextPageToken |
رمز مميز يمكن إرساله كـ |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
BusinessCallsInsights
إحصاءات المكالمات التي تم إجراؤها إلى أحد المواقع.
تمثيل JSON |
---|
{ "name": string, "metricType": enum ( |
الحقول | |
---|---|
name |
مطلوبة. اسم مورد إحصاءات المكالمات. التنسيق: المواقع الجغرافية/{location}/businesscallsinsights |
metricType |
المقياس الذي تنطبق عليه القيمة. |
aggregateMetrics |
مقياس للنطاق الزمني استنادًا إلى تاريخ البدء وتاريخ الانتهاء. |
MetricType
نوع المقياس.
عمليات التعداد | |
---|---|
METRIC_TYPE_UNSPECIFIED |
لم يتم تحديد نوع المقياس. |
AGGREGATE_COUNT |
المقاييس المقدَّمة هي أعداد مجمّعة على مدار النطاق_الزمني للإدخال. |
AggregateMetrics
يشير هذا المصطلح إلى المقاييس المجمّعة على مدار النطاق الزمني لإرسال البيانات.
تمثيل JSON |
---|
{ "missedCallsCount": integer, "answeredCallsCount": integer, "hourlyMetrics": [ { object ( |
الحقول | |
---|---|
missedCallsCount |
إجمالي عدد المكالمات الفائتة. |
answeredCallsCount |
إجمالي عدد المكالمات التي تم الردّ عليها. |
hourlyMetrics[] |
قائمة بالمقاييس حسب الساعة من اليوم. |
weekdayMetrics[] |
قائمة بالمقاييس حسب يوم الأسبوع. |
startDate |
تاريخ هذا المقياس إذا كان المقياس شهريًا، يتم استخدام السنة والشهر فقط. |
endDate |
تاريخ الانتهاء لهذا المقياس |
HourlyMetrics
يتم استخدام المقاييس لمدة ساعة.
تمثيل JSON |
---|
{ "hour": integer, "missedCallsCount": integer } |
الحقول | |
---|---|
hour |
ساعة من اليوم تتراوح القيم المسموح بها بين 0 و23. |
missedCallsCount |
إجمالي عدد المكالمات الفائتة لهذه الساعة. |
WeekDayMetrics
مقاييس لمدة يوم أسبوع
تمثيل JSON |
---|
{
"day": enum ( |
الحقول | |
---|---|
day |
يوم من الأسبوع. القيم المسموح بها هي من الأحد إلى السبت. |
missedCallsCount |
إجمالي عدد المكالمات الفائتة لهذه الساعة. |
DayOfWeek
يمثل أحد أيام الأسبوع.
عمليات التعداد | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
لَمْ يَتِمّْ تَحْدِيدُ الْيَوْمْ مِنَ الْأُسْبُوعْ. |
MONDAY |
الإثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
التاريخ
تمثّل تاريخًا كاملاً أو جزئيًا في التقويم، مثل تاريخ الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو هما غير مهمين. التاريخ مرتبط بالتقويم الميلادي. يمكن أن يمثّل ذلك أحد الأنواع التالية:
- تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
- شهر ويوم بدون عام (على سبيل المثال، ذكرى سنوية)
- عام بمفرده، وشهر صفر ويوم صفر
- سنة وشهر بدون يوم (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان)
الأنواع ذات الصلة: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
سنة من التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة يجب أن تتراوح القيمة من 1 إلى 12 أو 0 لتحديد عام بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر أو يجب أن تكون القيمة 0 لتحديد سنة بحد ذاتها أو عام وشهر لا يكون فيه اليوم مهمًا. |