سنوقف ميزة "الرسائل التجارية من Google" نهائيًا في 31 يوليو 2024. يمكنك الاطّلاع على مزيد من المعلومات
هنا.
Business Messages API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الخدمة: businessmessages.googleapis.com
للاتّصال بهذه الخدمة، ننصحك باستخدام عيّنات تقدّمها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.
المستند المرتبط بميزة "اقتراحات"
مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدّة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:
https://businessmessages.googleapis.com
الطُرق |
create |
POST /v1/{parent=conversations/*}/events
لإنشاء حدث في محادثة. |
الطُرق |
create |
POST /v1/{parent=conversations/*}/messages
يُرسِل رسالة من موظّف دعم إلى مستخدم. |
updateReceipt |
PATCH /v1/{receipt.name=conversations/*/messages/*/receipt}
يُرسِل إيصالاً لرسالة من موظّف دعم إلى مستخدم. |
الطُرق |
create |
POST /v1/{parent=conversations/*}/surveys
لإنشاء استطلاع رضا العملاء في محادثة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Business Messages API allows you to send and receive messages, create events, and manage customer satisfaction surveys within conversations.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides client libraries and samples to facilitate interaction with the API, although you can also use your own libraries.\u003c/p\u003e\n"],["\u003cp\u003eThe service endpoint for the API is \u003ccode\u003ehttps://businessmessages.googleapis.com\u003c/code\u003e, and all API requests should be relative to this endpoint.\u003c/p\u003e\n"],["\u003cp\u003eKey REST resources include conversations.events, conversations.messages, and conversations.surveys, offering functionalities like creating events, sending messages, and managing surveys.\u003c/p\u003e\n"],["\u003cp\u003eYou can find the Discovery Document at \u003ca href=\"https://businessmessages.googleapis.com/$discovery/rest?version=v1\"\u003ehttps://businessmessages.googleapis.com/$discovery/rest?version=v1\u003c/a\u003e for machine-readable specifications of the API.\u003c/p\u003e\n"]]],[],null,["# Business Messages API\n\nService: businessmessages.googleapis.com\n----------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [samples](/business-communications/business-messages/resources/samples). 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://businessmessages.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://businessmessages.googleapis.com`\n\nREST Resource: [v1.conversations.events](/business-communications/business-messages/reference/rest/v1/conversations.events)\n---------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|\n| [create](/business-communications/business-messages/reference/rest/v1/conversations.events/create) | `POST /v1/{parent=conversations/*}/events` Creates an event in a conversation. |\n\nREST Resource: [v1.conversations.messages](/business-communications/business-messages/reference/rest/v1/conversations.messages)\n-------------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|\n| [create](/business-communications/business-messages/reference/rest/v1/conversations.messages/create) | `POST /v1/{parent=conversations/*}/messages` Sends a message from an agent to a user. |\n| [updateReceipt](/business-communications/business-messages/reference/rest/v1/conversations.messages/updateReceipt) | `PATCH /v1/{receipt.name=conversations/*/messages/*/receipt}` Sends a receipt for a message from an agent to a user. |\n\nREST Resource: [v1.conversations.surveys](/business-communications/business-messages/reference/rest/v1/conversations.surveys)\n-----------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|\n| [create](/business-communications/business-messages/reference/rest/v1/conversations.surveys/create) | `POST /v1/{parent=conversations/*}/surveys` Creates a customer satisfaction survey in a conversation. |"]]