فهرست مطالب
-
BusinessCallsService
(رابط) -
AggregateMetrics
(پیام) -
BusinessCallsInsights
(پیام) -
BusinessCallsSettings
(پیام) -
BusinessCallsSettings.CallsState
(enum) -
ErrorCode
(enum) -
GetBusinessCallsSettingsRequest
(پیام) -
HourlyMetrics
(پیام) -
ListBusinessCallsInsightsRequest
(پیام) -
ListBusinessCallsInsightsResponse
(پیام) -
MetricType
(تعدادی) -
UpdateBusinessCallsSettingsRequest
(پیام) -
WeekDayMetrics
(پیام)
BusinessCallsService
این API به کسبوکارها اجازه میدهد تا تماسهای تجاری را مدیریت کنند و اطلاعات آماری مانند تعداد تماسهای بیپاسخ به مکان خود را جمعآوری کنند. اطلاعات بیشتر درباره تماسهای تجاری را میتوانید در https://support.google.com/business/answer/9688285?p=call_history بیابید
اگر نمایه کسبوکار Google به یک حساب Google Ads پیوند داده شود و سابقه تماس فعال باشد، تماسهایی که بیشتر از یک زمان خاص طول میکشند و میتوانند به یک تعامل تبلیغاتی نسبت داده شوند، در حساب Google Ads مرتبط در زیر «تماسها از طرف» نشان داده میشوند. تبدیل تبلیغات. اگر در استراتژی بهینهسازی از مناقصه هوشمند و تبدیل تماس استفاده شود، ممکن است تغییری در هزینه تبلیغات ایجاد شود. درباره مناقصه هوشمند بیشتر بدانید ."
برای مشاهده و انجام اقدامات روی تماسهای یک مکان، باید OWNER
، CO_OWNER
یا MANAGER
مکان باشید.
GetBusinessCallsSettings |
---|
منبع تنظیمات تماس های تجاری را برای مکان داده شده برمی گرداند.
|
ListBusinessCallsInsights |
---|
اطلاعات آماری تماسهای تجاری برای یک مکان را برمیگرداند.
|
UpdateBusinessCallsSettings |
---|
تنظیمات تماس تجاری را برای مکان مشخص شده به روز می کند.
|
AggregateMetrics
معیارها در محدوده زمانی ورودی جمعآوری میشوند.
زمینه های | |
---|---|
missed_calls_count | تعداد کل تماس های از دست رفته |
answered_calls_count | تعداد کل تماس های پاسخ داده شده |
hourly_metrics[] | فهرستی از معیارها بر حسب ساعت از روز. |
weekday_metrics[] | فهرستی از معیارها بر اساس روز هفته. |
start_date | تاریخ برای این معیار. اگر متریک ماهانه باشد، فقط از سال و ماه استفاده می شود. |
end_date | تاریخ پایان برای این سنجه. |
BusinessCallsInsights
اطلاعات آماری برای تماس های برقرار شده با یک مکان.
زمینه های | |
---|---|
name | ضروری. نام منبع اطلاعات تماس ها. قالب: مکانها/{location}/businesscallsinsights |
metric_type | معیاری که برای آن مقدار اعمال می شود. |
aggregate_metrics | متریک برای محدوده زمانی بر اساس start_date و end_date. |
BusinessCallsSettings
تنظیمات تماس های تجاری برای یک مکان.
زمینه های | |
---|---|
name | ضروری. نام منبع تنظیمات تماس. قالب: مکانها/{location}/businesscallssettings |
calls_state | ضروری. وضعیت ثبتنام این مکان در تماسهای تجاری. |
consent_time | فقط ورودی زمانی که کاربر نهایی رضایت کاربر API را برای فعال کردن تماس های تجاری ارائه کرد. |
CallsState
حالت های احتمالی یک مکان در تماس های تجاری. حالت ها را می توان فقط به فعال یا غیرفعال به روز کرد. هر چیز دیگری خطای PRECONDITION_FAILED را برمیگرداند.
Enums | |
---|---|
CALLS_STATE_UNSPECIFIED | نامشخص |
ENABLED | تماس های تجاری برای مکان فعال است. |
DISABLED | تماسهای تجاری برای مکان غیرفعال است. |
کد خطا
کدهای خطا برای خرابی های داخلی
Enums | |
---|---|
ERROR_CODE_UNSPECIFIED | کد خطای نامشخص |
ERROR_CODE_UNVERIFIED_LOCATION | مکان تأیید نشده است. |
ERROR_CODE_CALLS_NOT_ENABLED | وضعیت تماس های تجاری برای مکان فعال نیست. |
ERROR_CODE_NOT_ELIGIBLE_LOCATION | مکان برای تماس های کاری واجد شرایط نیست. |
GetBusinessCallsSettingsRequest
درخواست پیام برای GetBusinessCallsSettings.
زمینه های | |
---|---|
name | ضروری. BusinessCallsSettings را دریافت کنید. فیلد |
ساعتی متریک
متریک برای یک ساعت
زمینه های | |
---|---|
hour | ساعت از روز. مقادیر مجاز 0-23 هستند. |
missed_calls_count | تعداد کل تماس های از دست رفته برای این ساعت. |
ListBusinessCallsInsightsRequest
درخواست پیام برای ListBusinessCallsInsights.
زمینه های | |
---|---|
parent | ضروری. مکان والد برای واکشی اطلاعات آماری تماسها. قالب: مکانها/{location_id} |
page_size | اختیاری. حداکثر تعداد BusinessCallsInsights برای بازگشت. در صورت نامشخص حداکثر 20 عدد برگردانده می شود. برخی از metric_types (به عنوان مثال، AGGREGATE_COUNT) یک صفحه را برمی گرداند. برای این معیارها، page_size نادیده گرفته می شود. |
page_token | اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به |
filter | اختیاری. فیلتری که بینش تماس ها را برای بازگشت محدود می کند. پاسخ فقط شامل ورودی هایی می شود که با فیلتر مطابقت دارند. اگر MetricType ارائه نشده باشد، AGGREGATE_COUNT برگردانده می شود. اگر تاریخ پایانی ارائه نشده باشد، از آخرین تاریخی که دادهها برای آن موجود است استفاده میشود. اگر start_date ارائه نشود، به طور پیشفرض به اولین تاریخی که دادههای آن در دسترس است، که در حال حاضر 6 ماه است، میرسیم. اگر start_date قبل از تاریخی باشد که دادهها در دسترس هستند، دادهها از تاریخی که در دسترس هستند بازگردانده میشوند. در حال حاضر ما از فیلترهای زیر پشتیبانی می کنیم. 1. start_date="DATE" که در آن تاریخ در قالب YYYY-MM-DD است. 2. end_date="DATE" که در آن تاریخ در قالب YYYY-MM-DD است. 3. metric_type=XYZ که در آن XYZ یک MetricType معتبر است. 4. حروف ربط (AND) همه موارد فوق. به عنوان مثال، "start_date=2021-08-01 AND end_date=2021-08-10 AND metric_type=AGGREGATE_COUNT" AGGREGATE_COUNT metric_type قسمت DD تاریخ را نادیده می گیرد. |
ListBusinessCallsInsightsResponse
پیام پاسخ برای ListBusinessCallsInsights.
زمینه های | |
---|---|
business_calls_insights[] | مجموعهای از اطلاعات آماری برای مکان. |
next_page_token | یک نشانه، که می تواند به عنوان |
نوع متریک
نوع متریک.
Enums | |
---|---|
METRIC_TYPE_UNSPECIFIED | نوع متریک مشخص نشده است. |
AGGREGATE_COUNT | معیارهای ارائه شده، شمارشهایی هستند که در محدوده زمانی ورودی جمعآوری شدهاند. |
UpdateBusinessCallsSettingsRequest
درخواست پیام برای UpdateBusinessCallsSettings.
زمینه های | |
---|---|
business_calls_settings | ضروری. BusinessCallsSettings برای بهروزرسانی. فیلد |
update_mask | ضروری. لیست فیلدهایی که باید به روز شوند. |
WeekDayMetrics
معیارهای یک روز هفته
زمینه های | |
---|---|
day | روز هفته. مقادیر مجاز یکشنبه تا شنبه است. |
missed_calls_count | تعداد کل تماس های از دست رفته برای این ساعت. |