- طلب 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 أشهر. إذا كان 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 |
رمز مميز يمكن إرساله على شكل |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
BusinessCallsInsights
إحصاءات المكالمات التي يتم إجراؤها إلى أحد المواقع الجغرافية
تمثيل JSON |
---|
{ "name": string, "metricType": enum ( |
الحقول | |
---|---|
name |
مطلوب. اسم مورد إحصاءات المكالمات. التنسيق: location/{location}/businesscallsinsights |
metricType |
المقياس الذي تنطبق عليه القيمة. |
aggregateMetrics |
مقياس للنطاق الزمني يستند إلى startDate وendDate. |
MetricType
تمثّل هذه السمة نوع المقياس.
عمليات التعداد | |
---|---|
METRIC_TYPE_UNSPECIFIED |
لم يتم تحديد نوع المقياس. |
AGGREGATE_COUNT |
يتم تجميع المقاييس المقدَّمة خلال النطاق time_range للإدخال. |
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 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا. |