My Business Business Calls API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ה-My Business Calls API מנהל את פרטי השיחות העסקיות של מיקום ב-Google, ואוסף תובנות כמו מספר השיחות שלא נענו. מידע נוסף על שיחות עסקיות זמין בכתובת https://support.google.com/business/answer/9688285?p=call_history.
אם פרופיל העסק ב-Google מקושר לחשבון Google Ads והיסטוריית השיחות מופעלת, שיחות שנמשכות יותר מפרק זמן מסוים ושניתן לשייך אותן לאינטראקציה עם מודעה, יופיעו בחשבון Google Ads המקושר, בהמרה 'שיחות ממודעות'. אם משתמשים בשיטות בידינג חכמות ובהמרות מסוג שיחה בשיטת האופטימיזציה, יכול להיות שהוצאות הפרסום ישתנו. מידע נוסף על שיטות בידינג חכמות.
כדי להציג שיחות ממיקום ולבצע פעולות לגביהן, עליך להיות OWNER, CO_OWNER או MANAGER מהמיקום הזה.
שירות: mybusinesscalls.googleapis.com
כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, תוכלו להשתמש בפרטים הבאים כשתשלחו את בקשות ה-API.
מסמך Discovery
מסמך Discovery הוא מפרט קריא למחשבים שמיועד לתיאור ולשימוש בממשקי API ל-REST. הוא משמש לבניית ספריות לקוח, יישומי פלאגין ל-IDE וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:
נקודת הקצה של השירות
נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות ה-API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש את נקודת הקצה הבאה של השירות, וכל מזהי ה-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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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. |"]]
