ציין את כל 'אנשי הקשר הנוספים', כלומר אנשי קשר שלא נמצאים בקבוצת אנשי קשר. 'אנשי קשר נוספים' הם בדרך כלל אנשי קשר שנוצרים באופן אוטומטי מאינטראקציות.
התוקף של אסימוני הסנכרון פג 7 ימים אחרי הסנכרון המלא. בקשה עם אסימון סנכרון שפג תוקפו תקבל שגיאה עם google.rpc.ErrorInfo עם הסיבה 'EXPIRED_SYNC_TOKEN'. במקרה של שגיאה כזו, על הלקוחות לשלוח בקשת סנכרון מלאה ללא
.syncToken
לדף הראשון של בקשה לסנכרון מלא יש מכסה נוספת. אם חורגים מהמכסה, תוחזר שגיאה מסוג 429. המכסה הזו קבועה ואי אפשר להגדיל אותה.
אם מציינים את ה-
, משאבים שנמחקו מאז הסנכרון האחרון יוחזרו כאנשים שהשדה syncToken
מוגדר ל-true.PersonMetadata.deleted
כשמציינים
או pageToken
, כל שאר הפרמטרים של הבקשה צריכים להתאים לקריאה הראשונה.syncToken
ייתכן עיכוב של כמה דקות בהפצה של בקשות לסנכרון כהודעות כתיבה. סנכרונים מצטברים לא מיועדים לתרחישים לדוגמה של קריאה אחרי כתיבה.
אפשר לראות דוגמה לשימוש בקטע רשימת אנשי הקשר האחרים של המשתמש שהשתנו.
בקשת HTTP
GET https://people.googleapis.com/v1/otherContacts
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageToken |
זה שינוי אופציונלי. אסימון דף, שהתקבל מתגובה קודמת במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
pageSize |
זה שינוי אופציונלי. המספר של 'אנשי קשר נוספים' לכלול בתשובה. ערכים חוקיים הם בין 1 ל-1,000, כולל. ערך ברירת המחדל הוא 100 אם הערך לא מוגדר או מוגדר כ-0. |
requestSyncToken |
זה שינוי אופציונלי. האם התשובה צריכה להחזיר פרטים נוספים על פעולת הסנכרון זמינים בכתובת |
syncToken |
זה שינוי אופציונלי. אסימון סנכרון שהתקבל מתגובה קודמת במהלך הסנכרון, כל הפרמטרים האחרים שסופקו ל- פרטים נוספים על פעולת הסנכרון זמינים בכתובת |
readMask |
חובה. מסכת שדות להגבלת השדות בכל משתמש. כדי לציין כמה שדות, צריך להפריד ביניהם באמצעות פסיקים. הערכים החוקיים תלויים בסוג השימוש ב-ReadSourceType. אם משתמשים ב-READ_SOURCE_TYPE_CONTACT, הערכים החוקיים הם:
אם נעשה שימוש ב-READ_SOURCE_TYPE_PROFILE, הערכים החוקיים הם:
|
sources[] |
זה שינוי אופציונלי. מסכה של סוגי המקורות שיוחזרו. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא ערכים אפשריים לשדה הזה הם: אין לציין |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
התגובה לבקשה לקבל את 'אנשי קשר אחרים' של המשתמש המאומת.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"otherContacts": [
{
object ( |
שדות | |
---|---|
otherContacts[] |
הרשימה 'אנשי קשר נוספים' מוחזרים כמשאבים של אנשים. 'אנשי קשר נוספים' לתמוך בקבוצת משנה מוגבלת של שדות. למידע מפורט יותר, ראו ListOtherRequest.request_mask. |
nextPageToken |
אסימון, שניתן לשלוח בתור |
nextSyncToken |
אסימון, שניתן לשלוח בתור |
totalSize |
המספר הכולל של אנשי קשר אחרים ברשימה ללא חלוקה לדפים. |
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
מידע נוסף זמין במדריך להרשאות.