نظرة عامة حول واجهة برمجة التطبيقات لإعدادات المجموعات

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تُعدِّل "واجهة برمجة تطبيقات إعدادات المجموعات" الإعدادات وتستردها لمجموعة Google حالية. من خلال واجهة برمجة التطبيقات، يمكنك تنفيذ ما يلي:

  • عدِّل إعدادات المجموعة للدخول الداخلي إلى المجموعة الداخلية والخارجية.
  • تعديل إشعارات المجموعة.
  • ضبط أرشفة المناقشات والإشراف على الرسائل.
  • يمكنك تخصيص مجموعات مستخدمي حسابك.

للتعرُّف على مزيد من طرق العمل مع "مجموعات Google" أو إدارة أنواع أخرى من المجموعات، يُرجى الاطّلاع على مستندات Cloud Identity.

نموذج بيانات واجهة برمجة تطبيقات إعدادات المجموعات

تعمل واجهة برمجة تطبيقات إعدادات"مجموعات Google"على مورد Groups الذي يمثّل كيفية تواصل المستخدمين ضمن الحساب والتعاون مع مجموعات من المستخدمين الآخرين. يتم تحديد كل مجموعة من خلال عنوان البريد الإلكتروني للمجموعة.

يستند نموذج بيانات واجهة برمجة التطبيقات إلى مجموعة Groups من مجموعات الحسابات. لكل مجموعة مجموعة فريدة من إعدادات الضبط.

عمليات واجهة برمجة التطبيقات لإعدادات المجموعات

يمكنك استدعاء طرق إعدادات المجموعة في واجهة برمجة تطبيقات إعدادات المجموعات، كما هو موضح في الجدول التالي:

العملية الوصف تعيينات HTTP لـ REST
get يحصل على إعدادات مجموعة خاصة بحساب عميل. يجب تفويض جميع عمليات الحصول على الأذونات من مستخدم تمت مصادقته. GET على عنوان URL لمجموعة
update تعدِّل إعدادات مجموعة لحساب عميل. ويجب أن يسمح مستخدم تمت مصادقته بإجراء كل عمليات التعديل. PUT على عنوان URL لمجموعة

تنسيقات بيانات JSON وAtom

تعرض واجهة برمجة تطبيقات إعدادات "مجموعات Google" تلقائيًا البيانات بتنسيق JSON. يُعدّ ترميز Atom تنسيقًا بديلاً للبيانات. يتوافق كل من تنسيقَي بيانات JSON وAtom مع إمكانات القراءة والكتابة الكاملة.

JSON هو تنسيق شائع على الإنترنت يوفّر طريقة لتمثيل بُنى البيانات العشوائية. وفقًا لـ json.org، إنّ JSON هو تنسيق نصي مستقل تمامًا عن اللغة، ولكنه يستخدم اصطلاحات مألوفة لبرمجة مجموعة العائلة من اللغات، بما في ذلك C وC++ وC# وJava وJavaScript وPerl وPython.

لتغيير تنسيق بيانات واجهة برمجة التطبيقات، أدرِج سلسلة طلب البحث alt في معرّف الموارد المنتظم (URI) الخاص بطلبك، مثل:

JSON

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json

خلاصة Atom

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom