تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم هذه الصفحة نظرة عامة حول كيفية استخدام Google Chat API والمستندات المرجعية الخاصة به.
تتضمّن واجهة Google Chat API واجهتَي gRPC وREST، بالإضافة إلى مكتبات برامج متوافقة مع كلتيهما. يمكنك اختياريًا كتابة مكتبات برامج خاصة بك تستخدم واجهة gRPC أو REST إذا لم تلبِّ مكتبات البرامج المتوفّرة احتياجاتك.
مكتبات العملاء
الطريقة المقترَحة لمعظم المطوّرين لاستدعاء Google Chat API هي استخدام مكتبات Cloud Client Libraries المتوافقة رسميًا مع لغتك المفضّلة، مثل Python أو Java أو Node.js.
إذا كنت تكتب الرموز البرمجية باستخدام "برمجة تطبيقات Google"، استخدِم
خدمة Chat المتقدّمة
بدلاً من تثبيت مكتبة برامج العميل.
النوع والطريقة وأسماء الحقول
استنادًا إلى ما إذا كنت تستخدم مكتبات برامج أو gRPC أو REST، يختلف النوع والطريقة وأسماء الحقول لواجهة Google Chat API بعض الشيء:
يتم ترتيب "مكتبات البرامج للعملاء على السحابة الإلكترونية" حسب خدمات gRPC وطرقها.
يتم ترتيب مكتبات برامج Google API على شكل خدمات تحتوي على عناصر أو فئات تتوافق مع موارد REST، والتي تحتوي أيضًا على طرق متوافقة.
يتم ترتيب gRPC حسب الخدمات وطرقها.
يتم ترتيب REST حسب التسلسلات الهرمية للموارد وطرقها.
تستخدم أسماء حقول gRPC تنسيق snake case.
تستخدم أسماء حقول REST تنسيق CamelCase، مع أنّ خدمة واجهة برمجة التطبيقات تقبل تنسيق CamelCase أو snake_case.
تستخدم أسماء حقول مكتبة البرامج للعملاء حالة العنوان أو حالة Camel أو حالة Snake،
حسب الاسم المناسب للغة.
آليات سَلسلة البيانات المنظّمة
سواء كنت تستخدم مكتبات برامج أو REST أو gRPC، يتم تحديد الخدمة الأساسية باستخدام مخازن البروتوكول. على وجه الخصوص، تستخدم الخدمة proto3.
بالإضافة إلى ذلك، عند طلب بيانات من واجهة REST API، قد يؤدي سلوك القيمة التلقائية لمخازن البروتوكول إلى عدم توفّر بعض الحقول في استجابة JSON. يتم ضبط هذه الحقول على القيمة التلقائية، لذا لا يتم تضمينها في الردّ.
إصدارات واجهة برمجة التطبيقات
تتوفّر إصدارات واجهة برمجة التطبيقات التالية:
v1: إصدار ثابت.
معاينة المطور
في المستندات، قد تظهر لك طرق أو حقول خاصة بواجهة برمجة التطبيقات لا تتوفّر إلا من خلال "برنامج معاينة المطوّرين". لاختبار ميزات المعاينة الأحدث والاطّلاع عليها وتقديم الملاحظات بشأنها، يمكنك الانضمام إلى برنامج معاينة المطوّرين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This page offers guidance on utilizing the Google Chat API and navigating its reference documentation, including gRPC and REST interfaces."],["Developers are encouraged to use the provided client libraries for Python, Java, Node.js, or the Advanced Chat service for Google Apps Script."],["Type, method, and field names may vary slightly depending on whether you are using client libraries, gRPC, or REST, with details provided on their respective conventions."],["The Google Chat API is built upon protocol buffers, specifically proto3, which may require a basic understanding for certain request and response fields."],["Stable API version v1 is currently available, with access to developer preview features obtainable through the Developer Preview Program."]]],["The Google Chat API offers gRPC and REST interfaces, with corresponding client libraries or the option to create custom ones. Developers can use Cloud Client Libraries, or the Advanced Chat service with Google Apps Script. Type, method, and field names vary across libraries, gRPC, and REST. The API relies on protocol buffers (proto3), which can impact JSON responses due to default value behavior. The current stable version is v1, with a Developer Preview program for testing new features.\n"]]
