סקירה כללית של Groups Settings API

ה-API של הגדרות ההגדרות מתעדכן ומאחזר הגדרות של קבוצת Google קיימת. באמצעות ה-API ניתן לבצע את הפעולות הבאות:

  • שינוי ההגדרות של קבוצה לגישה פנימית וחיצונית.
  • עריכת ההתראות של הקבוצה.
  • הגדרת ניהול דיונים וניהול הודעות.
  • התאמה אישית של קבוצות המשתמשים בחשבון שלך.

דרכים נוספות לעבודה עם קבוצות Google או ניהול סוגים אחרים של קבוצות מפורטות במסמכי התיעוד של Cloud Identity.

מודל נתונים של Groups Settings API

ה-Groups Settings API פועל במשאב Groups שמייצג את האופן שבו משתמשים בחשבון מתקשרים עם קבוצות של אנשים אחרים ומשתפים פעולה איתם. כל קבוצה מזוהה לפי כתובת האימייל של הקבוצה.

מודל הנתונים של ה-API מבוסס על איסוף Groups של הקבוצות של החשבון&#39. לכל קבוצה יש קבוצה ייחודית של הגדרות אישיות.

פעולות API להגדרות של קבוצות Google

אפשר לקרוא לשיטות ההגדרות של קבוצות ב-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#, 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