Method: locations.businesscallsinsights.list

تعرض إحصاءات مكالمات النشاط التجاري لموقع جغرافي.

طلب HTTP

GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

مطلوبة. الموقع الجغرافي الرئيسي لجلب إحصاءات المكالمات له. التنسيق: المواقع الجغرافية/{locationId}

معلمات طلب البحث

المَعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد إحصاءات BusinessCallsInsights المطلوب عرضها. إذا لم يتم تحديد ذلك، سيتم إرجاع 20 طلب كحد أقصى. تعرض بعض أنواع المقاييس(مثل AGGREGATE_COUNT) صفحة واحدة. وبالنسبة إلى هذه المقاييس، يتم تجاهل pageSize.
pageToken

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ businesscallsinsights.list. قم بإدخاله لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى businesscallsinsights.list مع الطلب الذي قدَّم الرمز المميّز للصفحة. تعرض بعض أنواع المقاييس (مثل AGGREGATE_COUNT) صفحة واحدة. وبالنسبة إلى هذه المقاييس، يتم تجاهل pake_token.
filter

string

اختياريّ. فلتر يقيّد ظهور إحصاءات المكالمات. لا يتضمن الرد سوى الإدخالات التي تتطابق مع الفلتر.

إذا لم يتم توفير 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": string
}
الحقول
businessCallsInsights[]

object (BusinessCallsInsights)

مجموعة من إحصاءات مكالمات النشاط التجاري للموقع الجغرافي.
nextPageToken

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية إذا تم حذف هذا الحقل، لن تظهر أي صفحات لاحقة. تعرض بعض أنواع المقاييس (مثل AGGREGATE_COUNT) صفحة واحدة. وبالنسبة إلى هذه المقاييس، سيكون حقل NextPageToken فارغًا.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

BusinessCallsInsights

إحصاءات المكالمات التي تم إجراؤها إلى أحد المواقع.

تمثيل JSON 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
الحقول
name

string

مطلوبة. اسم مورد إحصاءات المكالمات. التنسيق: المواقع الجغرافية/{location}/businesscallsinsights
metricType

enum (MetricType)

المقياس الذي تنطبق عليه القيمة.
aggregateMetrics

object (AggregateMetrics)

مقياس للنطاق الزمني استنادًا إلى تاريخ البدء وتاريخ الانتهاء.

MetricType

نوع المقياس.

عمليات التعداد
METRIC_TYPE_UNSPECIFIED لم يتم تحديد نوع المقياس.
AGGREGATE_COUNT المقاييس المقدَّمة هي أعداد مجمّعة على مدار النطاق_الزمني للإدخال.

AggregateMetrics

يشير هذا المصطلح إلى المقاييس المجمّعة على مدار النطاق الزمني لإرسال البيانات.

تمثيل JSON 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
الحقول
missedCallsCount

integer

إجمالي عدد المكالمات الفائتة.
answeredCallsCount

integer

إجمالي عدد المكالمات التي تم الردّ عليها.
hourlyMetrics[]

object (HourlyMetrics)

قائمة بالمقاييس حسب الساعة من اليوم.
weekdayMetrics[]

object (WeekDayMetrics)

قائمة بالمقاييس حسب يوم الأسبوع.
startDate

object (Date)

تاريخ هذا المقياس إذا كان المقياس شهريًا، يتم استخدام السنة والشهر فقط.
endDate

object (Date)

تاريخ الانتهاء لهذا المقياس

HourlyMetrics

يتم استخدام المقاييس لمدة ساعة.

تمثيل JSON 
{
  "hour": integer,
  "missedCallsCount": integer
}
الحقول
hour

integer

ساعة من اليوم تتراوح القيم المسموح بها بين 0 و23.
missedCallsCount

integer

إجمالي عدد المكالمات الفائتة لهذه الساعة.

WeekDayMetrics

مقاييس لمدة يوم أسبوع

تمثيل JSON 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
الحقول
day

enum (DayOfWeek)

يوم من الأسبوع. القيم المسموح بها هي من الأحد إلى السبت.
missedCallsCount

integer

إجمالي عدد المكالمات الفائتة لهذه الساعة.

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

integer

سنة من التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

شهر من السنة يجب أن تتراوح القيمة من 1 إلى 12 أو 0 لتحديد عام بدون شهر ويوم.
day

integer

يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر أو يجب أن تكون القيمة 0 لتحديد سنة بحد ذاتها أو عام وشهر لا يكون فيه اليوم مهمًا.