نظرة عامة على Groups Settings API

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

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

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

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

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

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

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

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

العملية الوصف تعيينات REST HTTP
get الحصول على إعدادات مجموعة لحساب عميل يجب أن يتم السماح بجميع عمليات get من خلال مستخدم تمت المصادقة عليه. GET على معرّف موارد منتظم (URI) للمجموعة.
update تعديل إعدادات مجموعة لحساب عميل يجب أن يتم إجراء جميع عمليات التحديث من قِبل مستخدم تمت المصادقة عليه. PUT على معرّف موارد منتظم (URI) للمجموعة.

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

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

JSON هو تنسيق شائع على الإنترنت يوفر طريقة لتمثيل هياكل البيانات العشوائية. وفقًا للموقع الإلكتروني json.org، إنّ تنسيق JSON هو تنسيق نصي مستقل عن اللغة تمامًا، ولكنّه يستخدم اصطلاحات مألوفة لمبرمجي مجموعة اللغات C، بما في ذلك 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