מעתיק איש קשר אחר לאיש קשר חדש בקבוצה "myContacts" של המשתמש
בקשות לשינוי עבור אותו משתמש צריכות להישלח ברצף כדי למנוע זמן אחזור ארוך יותר וכשלים.
בקשת HTTP
POST https://people.googleapis.com/v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
resourceName |
חובה. שם המשאב של 'איש הקשר האחר' שיש להעתיק. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"copyMask": string,
"readMask": string,
"sources": [
enum ( |
שדות | |
---|---|
copyMask |
חובה. מסכת שדות להגבלת השדות שיועתקו לאיש הקשר החדש. הערכים החוקיים כוללים:
|
readMask |
זה שינוי אופציונלי. מסכת שדות שמגבילה את השדות שיוחזרו על ידי המשתמש. אפשר לציין כמה שדות על ידי הפרדה בפסיקים. ברירת המחדל היא מסכת ההעתקה עם שדות המטא-נתונים והחברות בקבוצה, אם היא לא מוגדרת. הערכים החוקיים כוללים:
|
sources[] |
זה שינוי אופציונלי. מסכה של סוגי המקורות שיש להחזיר. אם המדיניות לא מוגדרת, ברירת המחדל היא |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של Person
.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
https://www.googleapis.com/auth/contacts
למידע נוסף, עיינו במדריך ההרשאות.