Method: people.updateContact

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתות
• גוף הבקשה
• גוף התשובה
• היקפי הרשאות
• רוצים לנסות?

עדכון הפרטים ליצירת קשר של איש קשר קיים. נתונים שלא קשורים ליצירת קשר לא ישתנו. המערכת תתעלם מכל נתון של איש הקשר שאינו פרט ליצירת קשר. כל השדות שצוינו ב-updateMask יוחלפו.

השרת מחזיר שגיאה 400 אם לא צוין person.metadata.sources של איש הקשר שרוצים לעדכן, או אם אין מקור ליצירת קשר.

השרת מחזיר שגיאה 400 עם הסיבה "failedPrecondition" אם הערך של person.metadata.sources.etag שונה מה-etag של איש הקשר, כלומר איש הקשר השתנה מאז שהנתונים שלו נקראו. הלקוחות צריכים לקבל את האדם העדכני ביותר ולמזג את העדכונים שלהם עם האדם העדכני ביותר. אם מבצעים עדכונים רצופים לאותו אדם, צריך להשתמש ב-etag מהתגובה updateContact כדי למנוע כשלים.

השרת מחזיר שגיאה 400 אם מתבצע עדכון של memberships ואין למשתמש חברות בקבוצות של אנשי קשר.

השרת מחזיר שגיאה 400 אם צוין יותר משדה אחד בשדה שהוא יחיד עבור מקורות של אנשי קשר:

• ביוגרפיות
• ימי הולדת
• מינים
• שמות

כדי למנוע עלייה בזמן האחזור ובמספר הכשלים, צריך לשלוח בקשות לשינוי של אותו משתמש ברצף.

בקשת HTTP

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
person.resourceName	string שם המשאב של האדם, שהוקצה על ידי השרת. מחרוזת ASCII בפורמט people/{person_id}.

פרמטרים של שאילתה

פרמטרים
updatePersonFields	string (FieldMask format) חובה. אנונימיזציה של שדות כדי להגביל את השדות של האדם שעודכנו. אפשר לציין כמה שדות ולהפריד ביניהם באמצעות פסיקים. כל השדות המעודכנים יוחלפו. הערכים החוקיים כוללים: כתובות ביוגרפיות ימי הולדת calendarUrls clientData emailAddresses אירועים externalIds מינים imClients תחומי עניין לוקאלים locations מינויים miscKeywords שמות כינויים מקצועות ארגונים phoneNumbers יחסים sipAddresses כתובות אתרים userDefined
personFields	string (FieldMask format) אופציונלי. מסכת שדות כדי להגביל את השדות של כל אדם שיוחזרו. אפשר לציין כמה שדות ולהפריד ביניהם באמצעות פסיקים. אם לא מגדירים ערך, ברירת המחדל היא כל השדות. הערכים החוקיים כוללים: כתובות ageRanges ביוגרפיות ימי הולדת calendarUrls clientData coverPhotos emailAddresses אירועים externalIds מינים imClients תחומי עניין לוקאלים locations מינויים מטא נתונים miscKeywords שמות כינויים מקצועות ארגונים phoneNumbers תמונות, תצלומים, צילומים, פוטוס יחסים sipAddresses מיומנויות כתובות אתרים userDefined
sources[]	enum (ReadSourceType) אופציונלי. מסכה של סוגי המקורות להחזרה. אם הפרמטר לא הוגדר, ערכי ברירת המחדל שלו הם READ_SOURCE_TYPE_CONTACT ו-READ_SOURCE_TYPE_PROFILE.

גוף הבקשה

גוף הבקשה מכיל מופע של Person.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Person.

היקפי הרשאה

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

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

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