משנים את החברים בקבוצת אנשי קשר שבבעלות המשתמש המאומת.
הקבוצות היחידות של אנשי קשר במערכת שניתן להוסיף להן חברים הן contactGroups/myContacts
ו-contactGroups/starred
. קבוצות אחרות של אנשי קשר במערכת הוצאו משימוש, וניתן להסיר מהן רק אנשי קשר.
בקשת HTTP
POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
resourceName |
חובה. שם המשאב של קבוצת אנשי הקשר שברצונך לשנות. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "resourceNamesToAdd": [ string ], "resourceNamesToRemove": [ string ] } |
שדות | |
---|---|
resourceNamesToAdd[] |
זה שינוי אופציונלי. שמות המשאבים של אנשי הקשר שיש להוסיף בצורה של |
resourceNamesToRemove[] |
זה שינוי אופציונלי. שמות המשאבים של אנשי הקשר שיש להסיר בצורת |
גוף התשובה
התשובה לבקשה לשינוי חברים בקבוצה של אנשי הקשר.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "notFoundResourceNames": [ string ], "canNotRemoveLastContactGroupResourceNames": [ string ] } |
שדות | |
---|---|
notFoundResourceNames[] |
שמות המשאבים של אנשי הקשר לא נמצאו. |
canNotRemoveLastContactGroupResourceNames[] |
שמות המשאבים של אנשי קשר שלא ניתן להסיר מקבוצת אנשי הקשר האחרונה שלהם. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/contacts
למידע נוסף, עיינו במדריך ההרשאות.