עדכון תמונה של איש קשר.
בקשות לשינוי עבור אותו משתמש צריכות להישלח ברצף כדי למנוע זמן אחזור ארוך יותר וכשלים.
בקשת HTTP
PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
resourceName |
חובה. שם המשאב של האדם |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"photoBytes": string,
"personFields": string,
"sources": [
enum ( |
שדות | |
---|---|
photoBytes |
חובה. בייטים של תמונות גולמיות מחרוזת בקידוד base64. |
personFields |
זה שינוי אופציונלי. מסכת שדות שמגבילה את השדות שיוחזרו על ידי המשתמש. אפשר לציין כמה שדות על ידי הפרדה בפסיקים. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא ריק, והמערכת תדלג על קבלת השינוי של הפוסט. הערכים החוקיים כוללים:
|
sources[] |
זה שינוי אופציונלי. מסכה של סוגי המקורות שיש להחזיר. אם המדיניות לא מוגדרת, ברירת המחדל היא |
גוף התשובה
התשובה לעדכון התמונה של איש קשר.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"person": {
object ( |
שדות | |
---|---|
person |
המשתמש המעודכן, אם personFields מוגדר ב-UpdateContactPhotoRequest. אחרת, ההגדרה הזו לא תוגדר. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/contacts
למידע נוסף, עיינו במדריך ההרשאות.