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 أشهر. إذا كان startDate قبل تاريخ توفر البيانات، يتم عرض البيانات بدءًا من تاريخ توفرها.

تتوفّر حاليًا الفلاتر التالية. 1- startDate="DATE" حيث يكون التاريخ بتنسيق YYYY-MM-DD. 2. endDate="DATE" حيث يكون التاريخ بتنسيق YYYY-MM-DD. 3-metricType=XYZ حيث يكون XYZ قيمة MetricType صالحة. 4. وصلات(و) لكل ما سبق. مثلاً: "startDate=2021-08-01 AND endDate=2021-08-10 AND MetricsType=AGGREGATE_COUNT" يتجاهل AGGREGATE_COUNT MetricsType الجزء 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/{location}/businesscallsinsights

metricType

enum (MetricType)

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

aggregateMetrics

object (AggregateMetrics)

مقياس للنطاق الزمني يستند إلى startDate وendDate.

MetricType

تمثّل هذه السمة نوع المقياس.

عمليات التعداد
METRIC_TYPE_UNSPECIFIED لم يتم تحديد نوع المقياس.
AGGREGATE_COUNT يتم تجميع المقاييس المقدَّمة خلال النطاق time_range للإدخال.

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 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا.