Method: contactGroups.members.modify

משנים את החברים בקבוצת אנשי קשר שבבעלות המשתמש המאומת.

הקבוצות היחידות של אנשי קשר במערכת שניתן להוסיף להן חברים הן contactGroups/myContacts ו-contactGroups/starred. קבוצות אחרות של אנשי קשר במערכת הוצאו משימוש, וניתן להסיר מהן רק אנשי קשר.

בקשת HTTP

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
resourceName

string

חובה. שם המשאב של קבוצת אנשי הקשר שברצונך לשנות.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
שדות
resourceNamesToAdd[]

string

זה שינוי אופציונלי. שמות המשאבים של אנשי הקשר שיש להוסיף בצורה של people/{person_id}. המספר הכולל של שמות המשאבים ב-resourceNamesToAdd וב-resourceNamesToRemove חייב להיות פחות מ-1,000 או שווה ל-1.
resourceNamesToRemove[]

string

זה שינוי אופציונלי. שמות המשאבים של אנשי הקשר שיש להסיר בצורת people/{person_id}. המספר הכולל של שמות המשאבים ב-resourceNamesToAdd וב-resourceNamesToRemove חייב להיות פחות מ-1,000 או שווה ל-1.

גוף התשובה

התשובה לבקשה לשינוי חברים בקבוצה של אנשי הקשר.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
שדות
notFoundResourceNames[]

string

שמות המשאבים של אנשי הקשר לא נמצאו.
canNotRemoveLastContactGroupResourceNames[]

string

שמות המשאבים של אנשי קשר שלא ניתן להסיר מקבוצת אנשי הקשר האחרונה שלהם.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/contacts

למידע נוסף, עיינו במדריך ההרשאות.