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