הצגת רשימה של כל 'אנשי הקשר האחרים', כלומר אנשי קשר שלא נכללים בקבוצה של אנשי קשר. 'אנשי קשר אחרים' הם בדרך כלל אנשי קשר שנוצרים באופן אוטומטי מאינטראקציות.
התוקף של אסימוני סנכרון פג 7 ימים לאחר הסנכרון המלא. בקשה עם אסימון סנכרון שפג תוקפו תקבל שגיאה עם google.rpc.ErrorInfo עם הסיבה CCPAD_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, כולל. אם הערך לא מוגדר או מוגדר ל-0, ברירת המחדל היא 100. |
requestSyncToken |
זה שינוי אופציונלי. האם התגובה צריכה להחזיר פרטים נוספים על התנהגות הסנכרון זמינים בכתובת |
syncToken |
זה שינוי אופציונלי. אסימון סנכרון שהתקבל מתגובה קודמת במהלך הסנכרון, כל הפרמטרים האחרים שסופקו ל- פרטים נוספים על התנהגות הסנכרון זמינים בכתובת |
readMask |
חובה. אנונימיזציה של שדות להגבלת השדות שמוחזרים עבור כל אחד מהאנשים. אפשר לציין כמה שדות על ידי הפרדה בפסיקים. הערכים החוקיים תלויים בסוג ReadSourceType שבו נעשה שימוש. אם נעשה שימוש ב-READ_SOURCE_TYPE_CONTACT, הערכים החוקיים הם:
אם נעשה שימוש ב-READ_SOURCE_TYPE_PROFILE, הערכים החוקיים הם:
|
sources[] |
זה שינוי אופציונלי. מסכה של סוגי המקורות שיש להחזיר. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא הערכים האפשריים לשדה הזה הם: אין לציין |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
התשובה לבקשה של 'אנשי קשר נוספים' של המשתמש המאומת.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"otherContacts": [
{
object ( |
שדות | |
---|---|
otherContacts[] |
הרשימה של 'אנשי קשר אחרים' שהוחזרה כמשאבי אדם. האפשרות 'אנשי קשר אחרים' תומכת בקבוצת משנה מוגבלת של שדות. לפרטים נוספים, יש לעיין ב-ListOtherContactsRequest.request_security. |
nextPageToken |
אסימון, שיכול להישלח בתור |
nextSyncToken |
אסימון, שניתן לשלוח בתור |
totalSize |
המספר הכולל של אנשי קשר אחרים ברשימה ללא עימוד. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
למידע נוסף, עיינו במדריך ההרשאות.