تقدّم هذه الصفحة نظرة عامة حول كيفية استخدام 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 Platform من خلال خدمات gRPC وطرقها. يتم ترتيب مكتبات عملاء Google API كخدمات تحتوي على كائنات أو التي تتوافق مع موارد REST، والتي تحتوي أيضًا على الطرق.
- يتم ترتيب gRPC حسب الخدمات وأساليبها.
- يتم ترتيب REST حسب التسلسلات الهرمية للموارد وطرقها.
- تستخدم أسماء حقول gRPC حالة الثعبان.
- تستخدم أسماء حقول REST حالة الجمل، على الرغم من أن خدمة واجهة برمجة التطبيقات ستقبل أيًا مما يلي: حالة الجمل أو حالة الثعبان.
- تستخدم أسماء حقول مكتبة العملاء إما حالة العنوان أو حالة الجمل أو حالة الثعبان، اعتمادًا على الاسم الاصطلاحي للغة.
الموارد الاحتياطية للبروتوكول
سواء كنت تستخدم مكتبات العملاء أو REST أو gRPC، تكون الخدمة الأساسية محددة باستخدام الموارد الاحتياطية للبروتوكول. وعلى وجه الخصوص، تقدم الخدمة تستخدم proto3.
عند طلب بيانات من واجهة برمجة التطبيقات، يمكن أن تتطلب بعض حقول الطلب أو الرد توفير بيانات فهم الأنواع المعروفة للمخزن المؤقت للبروتوكول.
بالإضافة إلى ذلك، عند استدعاء واجهة برمجة تطبيقات REST، سلوك القيمة التلقائية للبروتوكول قد تؤدي الموارد الاحتياطية إلى فقدان حقول في استجابة JSON. هذه الحقول يتم تعيينها على القيمة الافتراضية، بحيث لا يتم تضمينها في الاستجابة.
إصدارات واجهة برمجة التطبيقات
تتوفّر الإصدارات التالية من واجهة برمجة التطبيقات:
- v1: ثابت
معاينة المطور
قد ترى في الوثائق طرق واجهة برمجة التطبيقات أو الحقول التي المتاحة من خلال "برنامج معاينة المطوّر". للاختبار والمعاينة والعرض ملاحظات حول أحدث ميزات المعاينة، والانضمام إلى برنامج معاينة المطوّرين