Groups Settings API מעדכן ומאחזר הגדרות של קבוצות Google קיימות. באמצעות ה-API, אפשר לבצע את הפעולות הבאות:
- לשנות את ההגדרות של קבוצה כדי לאפשר גישה לקבוצה פנימית ולקבוצה חיצונית.
- עורכים את ההתראות של הקבוצה.
- הגדרת העברה לארכיון של דיונים וניהול הודעות.
- התאמה אישית של קבוצות המשתמשים בחשבון.
במסמכי Cloud Identity יש מידע נוסף על דרכים אחרות לעבודה עם קבוצות Google או לניהול סוגים אחרים של קבוצות.
מודל הנתונים של Groups Settings API
ה-API של הגדרות הקבוצות פועל על משאב Groups שמייצג את האופן שבו משתמשים בחשבון מתקשרים ומשתפים פעולה עם קבוצות של אנשים אחרים.
כל קבוצה מזוהה באמצעות כתובת האימייל שלה.
מודל הנתונים של ה-API מבוסס על Groups אוסף הקבוצות של החשבון.
לכל קבוצה יש הגדרות ייחודיות.
פעולות של Groups Settings API
אפשר להפעיל שיטות של הגדרות קבוצה ב-Groups Settings API, כמו שמתואר בטבלה הבאה:
| פעולה | תיאור | מיפויים של REST HTTP |
|---|---|---|
get |
מקבל את ההגדרות של קבוצה בחשבון של לקוח. כל פעולות ה-get חייבות להיות מאושרות על ידי משתמש מאומת. | GET ב-URI של קבוצה. |
update |
עדכון ההגדרות של קבוצה בחשבון של לקוח. כל פעולות העדכון צריכות להיות מאושרות על ידי משתמש מאומת. | PUT ב-URI של קבוצה. |
פורמטים של נתונים JSON ו-Atom
כברירת מחדל, הנתונים מוחזרים מ-Groups Settings API בפורמט JSON. הסימון של Atom הוא פורמט נתונים חלופי. פורמטי הנתונים JSON ו-Atom תומכים ביכולות מלאות של קריאה וכתיבה.
JSON הוא פורמט אינטרנט נפוץ שמספק שיטה לייצוג של מבני נתונים שרירותיים. לפי json.org, JSON הוא פורמט טקסט שאינו תלוי בשפה, אבל הוא משתמש במוסכמות שמוכרות למתכנתים בשפות ממשפחת C, כולל C, C++, C#, Java, JavaScript, Perl ו-Python.
אפשר לשנות את פורמט הנתונים של ה-API על ידי הכללת מחרוזת השאילתה 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