تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعمل واجهة برمجة التطبيقات لإعدادات "مجموعات 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) للطلب، على سبيل المثال:
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Groups Settings API overview\n\nThe Groups Settings API updates and retrieves settings for an existing\n[Google Group](https://support.google.com/a/topic/25838?&ref_topic=9197). Through\nthe API, you can do the following:\n\n- Modify a group's settings for internal and external group access.\n- Edit the group's notifications.\n- Configure discussion archiving and message moderation.\n- Customize your account's user groups.\n\nFor more ways to work with Google Groups, or manage other types of groups, see the\n[Cloud Identity documentation](https://cloud.google.com/identity/docs).\n\n### Groups Settings API data model\n\nThe Groups Settings API operates on a `Groups` resource which represents how users\nwithin an account communicate and collaborate with groups of other people. Each group is identified\nby the group's email address.\n\nThe API data model is based on the `Groups` collection of the account's groups. Each\ngroup has a unique set of configuration settings.\n\n### Groups Settings API operations\n\nYou can call group settings methods in the Groups Settings API, as described in the following\ntable:\n\n| Operation | Description | REST HTTP mappings |\n|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|\n| `get` | Gets a group's settings for a customer's account. All get operations must be authorized by an [authenticated](/workspace/guides/auth-overview) user. | `GET` on a group URI. |\n| `update` | Updates a group's settings for a customer's account. All update operations must be authorized by an [authenticated](/workspace/guides/auth-overview) user. | `PUT` on a group URI. |\n\nJSON and Atom data formats\n--------------------------\n\nBy default, the Groups Settings API returns data in JSON format. The Atom notation is an alternate\ndata format. Both the JSON and Atom data formats support full read-write capabilities.\n\nJSON is a common\ninternet format that provides a method of representing arbitrary data structures. According to\n[json.org](http://www.json.org), JSON is a text format\nthat is completely language-independent but uses conventions that are familiar to programmers of\nthe C-family of languages, including C, C++, C#, Java, JavaScript, Perl, and Python.\n\n\u003cbr /\u003e\n\nTo change the API's data format, include the `alt` query string in your request's\nURI---for example:\n\n### JSON\n\n```\nGET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json\n```\n\n### Atom\n\n```\nGET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom\n```"]]
