Contacts

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

אדם או קבוצה שיכולים לשמש כיוצרים או כאנשי קשר.

{
  "kind": "mirror#contact",
  "source": string,
  "id": string,
  "displayName": string,
  "imageUrls": [
    string
  ],
  "type": string,
  "acceptTypes": [
    string
  ],
  "phoneNumber": string,
  "priority": unsigned integer,
  "acceptCommands": [
    {
      "type": string
    }
  ],
  "speakableName": string,
  "sharingFeatures": [
    string
  ]
}
שם הנכס ערך תיאור הערות
acceptCommands[] list רשימת פקודות בתפריט הקולי שאיש קשר יכול לטפל בהן. ב-Glass מוצגים עד שלושה אנשי קשר בכל פקודה קולית בתפריט. אם יש מספר גדול יותר של יעדים, שלושת אנשי הקשר עם הערך priority הגבוה ביותר יוצגו עבור הפקודה הספציפית הזו. ניתן לכתיבה
acceptCommands[].type string סוג הפעולה שהפקודה הזו מתייחסת אליה. הערכים המותרים הם:
  • TAKE_A_NOTE – שיתוף פריט בציר הזמן עם תמליל הדיבור של המשתמש מההערה 'סיכום הערה' פקודה קולית בתפריט.
  • POST_AN_UPDATE – שיתוף פריט בציר הזמן עם תמליל הדיבור של המשתמש מהקטע 'פרסום עדכון' פקודה קולית בתפריט.
ניתן לכתיבה
acceptTypes[] list רשימה של סוגי MIME שבהם אנשי קשר תומכים. איש הקשר יוצג למשתמש אם אחד מסוגי ה-AcceptType שלו תואם לאחד מסוגי הקבצים המצורפים בפריט. אם לא תספקו ערכים קבילים, איש הקשר יוצג לכל הפריטים. ניתן לכתיבה
displayName string השם שיוצג עבור איש הקשר הזה. ניתן לכתיבה
id string המזהה של איש הקשר הזה. המזהה נוצר על ידי האפליקציה ומטופל כמו אסימון אטום. ניתן לכתיבה
imageUrls[] list קבוצה של כתובות URL של תמונות שיוצגו עבור איש קשר. לרוב אנשי הקשר תהיה תמונה אחת, אבל 'קבוצה' אנשי קשר יכולים לכלול עד 8 כתובות URL של תמונות. הגודל שלהן ישתנה וייחתך לפסיפס בצד הלקוח. ניתן לכתיבה
kind string סוג המשאב. הערך הוא תמיד mirror#contact.
phoneNumber string מספר הטלפון הראשי של איש הקשר. המספר הזה יכול להיות מספר שמוגדר במלואו, כולל קידומת החיוג של המדינה וקידומת האזור, או מספר מקומי. ניתן לכתיבה
priority unsigned integer עדיפות לאיש הקשר כדי לקבוע את סדר הכרטיסים ברשימת אנשי הקשר. אנשי הקשר שקיבלו עדיפות גבוהה יותר יוצגו לפני אנשי קשר שקיבלו עדיפות נמוכה יותר. ניתן לכתיבה
sharingFeatures[] list רשימה של תכונות שיתוף שאיש קשר יכול לטפל בהן. הערכים המותרים הם:
  • ADD_CAPTION
source string מזהה האפליקציה שיצרה את איש הקשר הזה. השדה הזה מאוכלס על ידי ה-API
speakableName string השם של איש הקשר כפי שצריך לבטא אותו. אם צריך לומר את השם של איש הקשר כחלק מתפריט הבהרה קולי, השם הזה ישמש להגייה הצפויה. האפשרות הזו שימושית לשמות של אנשי קשר שמכילים תווים שלא ניתנים להגייה או שהאיות המוצג שלהם אינו פונטי מסיבה אחרת. ניתן לכתיבה
type string הסוג של איש הקשר הזה. הוא משמש למיון בממשק משתמש. הערכים המותרים הם:
  • INDIVIDUAL – מייצג אדם אחד. (זוהי ברירת המחדל)
  • GROUP – מייצג יותר מאדם אחד.
ניתן לכתיבה

שיטות

מחיקה
מוחק איש קשר.
הורדה
מקבל איש קשר אחד לפי מזהה.
הוספה
הוספת איש קשר חדש.
list
אחזור רשימה של אנשי קשר של המשתמש המאומת.
תיקון
מעדכנת איש קשר קיים. השיטה הזו תומכת בסמנטיקה של תיקונים.
עדכון
מעדכנת איש קשר קיים.