تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
My Business Business Calls API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تدير واجهة برمجة التطبيقات لمكالمات النشاط التجاري في "نشاطي التجاري على Google" معلومات مكالمات النشاط التجاري لموقع جغرافي معيّن على Google، بالإضافة إلى جمع إحصاءات مثل عدد المكالمات الفائتة الواردة إلى موقعه الجغرافي. يمكنك العثور على معلومات إضافية عن مكالمات النشاط التجاري على الرابط https://support.google.com/business/answer/9688285?p=call_history.
إذا كان "الملف التجاري على Google" يتضمّن رابطًا إلى حساب "إعلانات Google" وتم تفعيل سجلّ المكالمات، ستظهر المكالمات التي تستمر لفترة أطول من وقت محدّد ويمكن إسنادها إلى تفاعل مع الإعلان في حساب "إعلانات Google" المرتبط ضمن الإحالة الناجحة "المكالمات الواردة من الإعلانات". إذا تم استخدام عروض الأسعار الذكية والإحالات الناجحة عبر الاتصال الهاتفي في استراتيجية التحسين، قد يحدث تغيير في الإنفاق الإعلاني. اطّلِع على مزيد من المعلومات عن عروض الأسعار الذكية.
للاطّلاع على مكالمات أحد المواقع الجغرافية وتنفيذ إجراءات بشأنها، يجب أن تكون OWNER أو CO_OWNER أو MANAGER في الموقع الجغرافي.
الخدمة: mybusinesscalls.googleapis.com
للاتصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لاستدعاء هذه الخدمة، فاستخدم المعلومات التالية عند تقديم طلبات واجهة برمجة التطبيقات.
مستند "اقتراحات"
مستند الاستكشاف هو مواصفات يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات للعملاء ومكوّنات IDE وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفّر هذه الخدمة مستند الاستكشاف التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية مرتبطة بنقطة نهاية الخدمة هذه:
https://mybusinessbusinesscalls.googleapis.com
| الطُرق |
getBusinesscallssettings |
GET /v1/{name=locations/*/businesscallssettings}
لعرض مورد إعدادات مكالمات النشاط التجاري للموقع الجغرافي المحدد. |
updateBusinesscallssettings |
PATCH /v1/{businessCallsSettings.name=locations/*/businesscallssettings}
يعدّل إعدادات مكالمة النشاط التجاري للموقع الجغرافي المحدّد. |
| الطُرق |
list |
GET /v1/{parent=locations/*}/businesscallsinsights
تعرض إحصاءات مكالمات النشاط التجاري لموقع جغرافي. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe My Business Business Calls API allows you to manage and analyze business call data for Google Business Profile locations, including insights like missed calls.\u003c/p\u003e\n"],["\u003cp\u003eWhen linked with Google Ads and call history enabled, eligible calls may appear as conversions, potentially impacting ad spending with smart bidding.\u003c/p\u003e\n"],["\u003cp\u003eYou need specific roles (\u003ccode\u003eOWNER\u003c/code\u003e, \u003ccode\u003eCO_OWNER\u003c/code\u003e, or \u003ccode\u003eMANAGER\u003c/code\u003e) to access and manage a location's call data.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides resources to retrieve Business Calls settings and insights, and is accessible through Google-provided client libraries or REST endpoints.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the provided discovery document and service endpoint for integration and interaction with the API.\u003c/p\u003e\n"]]],["The My Business Business Calls API enables management of business call data for Google locations, including insights like missed calls. Users with `OWNER`, `CO_OWNER`, or `MANAGER` roles can access and modify call settings and retrieve business call insights using `GET` and `PATCH` methods on resources. If call history is enabled and the location is linked to Google Ads, calls longer than a set duration that came from an ad can be tracked in Google Ads and could influence ad spending.\n"],null,["# My Business Business Calls API\n\nThe My Business Business Calls API manages business calls information of a location on Google and collect insights like the number of missed calls to their location. Additional information about Business calls can be found at \u003chttps://support.google.com/business/answer/9688285?p=call_history.\u003e \n\nIf the Google Business Profile links to a Google Ads account and call history is turned on, calls that last longer than a specific time, and that can be attributed to an ad interaction, will show in the linked Google Ads account under the \"Calls from Ads\" conversion. If smart bidding and call conversions are used in the optimization strategy, there could be a change in ad spend. [Learn more about smart bidding](https://support.google.com/google-ads/answer/7065882). \n\nTo view and perform actions on a location's calls, you need to be a `OWNER`, `CO_OWNER` or `MANAGER` of the location.\n\n- [REST Resource: v1.locations](#v1.locations)\n- [REST Resource: v1.locations.businesscallsinsights](#v1.locations.businesscallsinsights)\n\nService: mybusinessbusinesscalls.googleapis.com\n-----------------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://mybusinessbusinesscalls.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://mybusinessbusinesscalls.googleapis.com`\n\nREST Resource: [v1.locations](/my-business/reference/businesscalls/rest/v1/locations)\n-------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| [getBusinesscallssettings](/my-business/reference/businesscalls/rest/v1/locations/getBusinesscallssettings) | `GET /v1/{name=locations/*/businesscallssettings}` Returns the Business calls settings resource for the given location. |\n| [updateBusinesscallssettings](/my-business/reference/businesscalls/rest/v1/locations/updateBusinesscallssettings) | `PATCH /v1/{businessCallsSettings.name=locations/*/businesscallssettings}` Updates the Business call settings for the specified location. |\n\nREST Resource: [v1.locations.businesscallsinsights](/my-business/reference/businesscalls/rest/v1/locations.businesscallsinsights)\n---------------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| [list](/my-business/reference/businesscalls/rest/v1/locations.businesscallsinsights/list) | `GET /v1/{parent=locations/*}/businesscallsinsights` Returns insights for Business calls for a location. |"]]
