Groups Settings API מעדכן ומאחזר הגדרות של קבוצת Google קיימת. באמצעות ה-API תוכלו לבצע את הפעולות הבאות:
- לשנות את ההגדרות של קבוצה לגישה פנימית וחיצונית.
- עורכים את ההתראות של הקבוצה.
- הגדרת העברה של דיונים לארכיון וניהול הודעות.
- להתאים אישית את קבוצות המשתמשים בחשבון.
דרכים נוספות לעבוד עם קבוצות Google או לנהל סוגים אחרים של קבוצות מפורטות במסמכי התיעוד של Cloud Identity.
מודל הנתונים של Groups Settings API
ה-API של הגדרות הקבוצות פועל על משאב Groups שמייצג את האופן שבו משתמשים בחשבון מתקשרים ועובדים בשיתוף פעולה עם קבוצות של אנשים אחרים. כל קבוצה מזוהה באמצעות כתובת האימייל שלה.
מודל הנתונים של API מבוסס על האוסף Groups של הקבוצות בחשבון. לכל קבוצה יש קבוצה ייחודית של הגדרות אישיות.
פעולות של Groups Settings API
אפשר להפעיל שיטות של הגדרות קבוצה ב-Groups Settings API, כפי שמתואר בטבלה הבאה:
| פעולה | תיאור | מיפויים של HTTP ל-REST |
|---|---|---|
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