Package google.mybusiness.businesscalls.v1

الفهرس

BusinessCallsService

تتيح واجهة برمجة التطبيقات هذه للأنشطة التجارية إدارة مكالمات النشاط التجاري وجمع إحصاءات مثل عدد المكالمات الفائتة إلى موقعهم الجغرافي. يمكنك العثور على معلومات إضافية حول مكالمات النشاط التجاري على https://support.google.com/business/answer/9688285?p=call_history

إذا كان "الملف التجاري على Google" مرتبطًا بحساب على "إعلانات Google" وكان سجلّ المكالمات مفعّلاً، ستظهر المكالمات التي تستمر لفترة أطول من وقت محدّد ويمكن إحالتها إلى التفاعل مع الإعلان في حساب "إعلانات Google" المرتبط ضمن الإحالة الناجحة "المكالمات من الإعلانات". إذا تم استخدام عروض الأسعار الذكية والإحالات الناجحة عبر الاتصال الهاتفي في استراتيجية التحسين، قد يحدث تغيير في الإنفاق الإعلاني. اطّلِع على مزيد من المعلومات عن عروض الأسعار الذكية".

لعرض مكالمات أحد المواقع الجغرافية وتنفيذ إجراءات بشأنها، يجب أن تكون OWNER أو CO_OWNER أو MANAGER في الموقع الجغرافي.

GetBusinessCallsSettings

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

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

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

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

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

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

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

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

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

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

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

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

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

لتعديل إعدادات مكالمة النشاط التجاري للموقع الجغرافي المحدّد

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

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

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

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

AggregateMetrics

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

الحقول
missed_calls_count

Int32Value

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

Int32Value

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

HourlyMetrics

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

WeekDayMetrics

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

Date

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

Date

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

BusinessCallsInsights

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

الحقول
name

string

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

MetricType

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

AggregateMetrics

مقياس للنطاق الزمني استنادًا إلى start_date وend_date.

BusinessCallsSettings

إعدادات مكالمات النشاط التجاري لموقع جغرافي

الحقول
name

string

مطلوبة. اسم المورد لإعدادات المكالمات. التنسيق: المواقع/{location}/businesscallssettings
calls_state

CallsState

مطلوبة. حالة تسجيل هذا الموقع الجغرافي في مكالمات النشاط التجاري
consent_time

Timestamp

الإدخال فقط. الوقت الذي يقدم فيه المستخدم النهائي موافقته على مستخدم واجهة برمجة التطبيقات لتفعيل مكالمات النشاط التجاري.

CallsState

الحالات المحتملة للموقع الجغرافي في مكالمات النشاط التجاري يمكن تعديل الحالات إلى "مفعَّلة" أو "غير مفعَّلة" فقط. أي شيء آخر سيؤدي إلى عرض خطأ PRECondition_FAILED.

عمليات التعداد
CALLS_STATE_UNSPECIFIED غير محدد
ENABLED تم تفعيل مكالمات النشاط التجاري للموقع الجغرافي.
DISABLED تم إيقاف مكالمات النشاط التجاري للموقع الجغرافي.

ErrorCode

رموز خطأ للأعطال الداخلية

عمليات التعداد
ERROR_CODE_UNSPECIFIED رمز خطأ غير محدَّد.
ERROR_CODE_UNVERIFIED_LOCATION لم يتم إثبات ملكية الموقع الجغرافي.
ERROR_CODE_CALLS_NOT_ENABLED حالة مكالمات النشاط التجاري للموقع الجغرافي غير مفعَّلة.
ERROR_CODE_NOT_ELIGIBLE_LOCATION الموقع الجغرافي غير مؤهَّل لمكالمات النشاط التجاري.

GetBusinessCallsSettingsRequest

طلب رسالة بشأن GetBusinessCallsSettings.

الحقول
name

string

مطلوبة. BusinessCallsSettings للحصول عليها.

يُستخدم الحقل name لتحديد إعدادات مكالمة النشاط التجاري التي يجب الحصول عليها. التنسيق: المواقع/{location_id}/businesscallssettings.

HourlyMetrics

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

الحقول
hour

Int32Value

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

Int32Value

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

ListBusinessCallsInsightsRequest

طلب رسالة من ListBusinessCallsInsights.

الحقول
parent

string

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

int32

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

string

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

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

string

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

إذا لم يتم توفير MetricType، فسيتم عرض AGGREGATE_COUNT. إذا لم يتم تقديم تاريخ انتهاء، سيتم استخدام آخر تاريخ تتوفّر فيه البيانات. وإذا لم يتم تقديم start_date، سيتم تلقائيًا تحديد التاريخ الأول الذي تتوفّر له البيانات، وهو حاليًا 6 أشهر. إذا كان start_date قبل التاريخ الذي تتوفر فيه البيانات، يتم إرجاع البيانات بدءًا من التاريخ الذي تكون متاحة فيه.

في الوقت الحالي، نتيح استخدام الفلاتر التالية. 1. start_date="DATE" حيث التاريخ بتنسيق YYYY-MM-DD. 2- end_date="DATE" حيث التاريخ بالتنسيق YYYY-MM-DD. 3- Metrics_type=XYZ حيث يكون XYZ هو MetricType صالح. 4. الاقتران(و) لكل ما سبق. على سبيل المثال، "start_date=2021-08-01 AND end_date=2021-08-10 ANDmetric_type=AGGREGATE_COUNT" يتجاهل AGGREGATE_COUNT متريّ نوع المقياس DD من التاريخ.

ListBusinessCallsInsightsResponse

رسالة ردّ لـ ListBusinessCallsInsights.

الحقول
business_calls_insights[]

BusinessCallsInsights

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

string

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

MetricType

نوع المقياس.

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

UpdateBusinessCallsSettingsRequest

طلب رسالة بشأن UpdateBusinessCallsSettings.

الحقول
business_calls_settings

BusinessCallsSettings

مطلوبة. BusinessCallsSettings المطلوب تحديثها.

يُستخدم الحقل name لتحديد إعدادات مكالمة النشاط التجاري المطلوب تعديلها. التنسيق: المواقع/{location_id}/businesscallssettings
update_mask

FieldMask

مطلوبة. قائمة الحقول المطلوب تعديلها.

WeekDayMetrics

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

الحقول
day

DayOfWeek

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

Int32Value

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