تعمل واجهة برمجة تطبيقات إعدادات "مجموعات Google" على تعديل إعدادات مجموعات Google الحالية واستردادها. من خلال واجهة برمجة التطبيقات، يمكنك إجراء ما يلي:
- تعديل إعدادات المجموعة للوصول إلى المجموعات الداخلية والخارجية
- تعديل إشعارات المجموعة
- ضبط إعدادات أرشفة المناقشات والإشراف على الرسائل
- تخصيص مجموعات المستخدمين في حسابك
لمزيد من الطرق للعمل مع "مجموعات Google" أو إدارة أنواع أخرى من المجموعات، يُرجى الاطّلاع على مستندات Cloud Identity.
نموذج بيانات Groups Settings API
تعمل واجهة برمجة التطبيقات لإعدادات المجموعات على مورد Groups يمثّل طريقة تواصل المستخدمين وتعاونهم مع مجموعات من المستخدمين الآخرين ضمن حساب معيّن.
يتم تحديد كل مجموعة من خلال عنوان البريد الإلكتروني الخاص بها.
يستند نموذج بيانات واجهة برمجة التطبيقات إلى مجموعة Groups الخاصة بالمجموعات في الحساب.
تحتوي كل مجموعة على مجموعة فريدة من إعدادات الضبط.
عمليات واجهة برمجة تطبيقات إعدادات "مجموعات Google"
يمكنك استدعاء طرق إعدادات المجموعة في واجهة برمجة تطبيقات إعدادات "مجموعات Google"، كما هو موضّح في الجدول التالي:
| العملية | الوصف | عمليات ربط REST HTTP |
|---|---|---|
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