تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم هذه الصفحة نظرة عامة حول كيفية استخدام Google Chat API ومستندات مرجعي
ة.
تتضمّن Google Chat API واجهات gRPC و
REST، و
مكتبات عملاء متوافقة مع كليهما. يمكنك اختياريًا كتابة مكتبات عملاء خاصة بك تستخدم واجهة gRPC أو REST إذا كانت مكتبات العملاء المقدَّمة لا تلبي احتياجاتك.
مكتبات العملاء
إنّ الطريقة المُقترَحة لمعظم المطوّرين للاتّصال بواجهة برمجة التطبيقات Google Chat API هي باستخدام مكتبات عملاء Cloud المتوافقة رسميًا بلغتك المفضّلة، مثل Python أو Java أو Node.js.
إذا كنت تُنشئ الرموز البرمجية باستخدام "برمجة تطبيقات Google"، استخدِم
خدمة Chat المتقدّمة
بدلاً من تثبيت مكتبة عملاء.
أسماء النوع والطريقة والحقول
استنادًا إلى ما إذا كنت تستخدم مكتبات العملاء أو gRPC أو REST، يختلف نوع واجهة برمجة التطبيقات Google Chat API
وطريقة استخدامها وأسماء الحقول إلى حدٍ ما:
يتم ترتيب مكتبات برامج Cloud Client حسب خدمات gRPC وطرقها.
يتم ترتيب مكتبات عملاء Google API كخدمات تحتوي على عناصر أو
فئات تتوافق مع موارد REST التي تحتوي أيضًا على
طُرق مقابلة.
يتم ترتيب gRPC حسب الخدمات وطُرقها.
يتم ترتيب بروتوكول REST حسب التسلسلات الهرميّة للموارد وطُرقها.
تستخدم أسماء حقول gRPC أسلوب الكتابة بالتنسيق snake case.
تستخدم أسماء حقول REST أسلوب CamelCase، على الرغم من أنّ خدمة واجهة برمجة التطبيقات ستقبل أسلوب
CamelCase أو أسلوب SnakeCase.
تستخدم أسماء حقول مكتبة العميل إما حالة أحرف العنوان أو حالة أحرف الجمل أو حالة الثعبان،
استنادًا إلى الاسم الشائع في اللغة.
آليات سَلسلة البيانات المنظّمة
سواء كنت تستخدم مكتبات العملاء أو REST أو gRPC، يتم تحديد الخدمة الأساسية باستخدام بروتوكول Buffers. على وجه التحديد، تستخدم الخدمة
proto3.
بالإضافة إلى ذلك، عند طلب البيانات من واجهة برمجة التطبيقات REST API، قد يؤدي سلوك
القيمة التلقائية لمخازن ملفّات
البروتوكول إلى عدم توفّر حقول في استجابة JSON. يتم ضبط هذه الحقول
على القيمة التلقائية، لذا لا يتم تضمينها في الاستجابة.
إصدارات واجهة برمجة التطبيقات
تتوفّر إصدارات واجهة برمجة التطبيقات التالية:
v1: إصدار ثابت.
معاينة المطور
في المستندات، قد تظهر لك طرق أو حقول واجهة برمجة التطبيقات التي لا تتوفّر إلا
من خلال "برنامج معاينة المطوّرين". لاختبار أحدث ميزات المعاينة ومعاينتها وتقديم ملاحظات بشأنها، يمكنك الانضمام إلى
برنامج معاينة المطوّرين.
تاريخ التعديل الأخير: 2025-02-16 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-02-16 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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"]]
