חשוב: חשוב להעביר את הסקריפטים מהשירות של 'אנשי קשר' לשירות המתקדם שלPeople API, לפני ההוצאה משימוש של שירות 'אנשי קשר' במרץ 2023.
השירות 'אנשי קשר' הוצא משימוש ב-Apps Script בתאריך 16 בדצמבר 2022. במקום זאת, השתמשו בשירות המתקדם שלPeople API. ה-People API משתמש בפרוטוקול JSON חדש יותר ומספק תכונות מתקדמות, כמו מיזוג אנשי קשר עם פרופילים.
במדריך הזה נסביר לאילו שיטות של שירות 'אנשי קשר' אין מקבילות בשירות המתקדם של Contact API, נסביר במה אפשר להשתמש במקום זאת ולמצוא דוגמאות קוד להעברת משימות נפוצות. למידע נוסף, קראו את המדריך להעברת ממשק ה-API של אנשי הקשר.
שיטות ללא מקבילות ב-People API
ברשימה הבאה מפורטות שיטות getContacts
בשירות 'אנשי קשר' שאין להן דרכים מקבילות לחיפוש אנשי קשר בשירות המתקדם שלPeople API. בעזרת השירות המתקדם של Contact API, ניתן לחפש לפי השדות names
, nickNames
, emailAddresses
, phoneNumbers
ו-organizations
של אנשי הקשר מהמקור CONTACT
.
שיטות ללא מקבילות |
---|
|
ברשימה הבאה מפורטות שיטות getContacts
מהשירות 'אנשי קשר', שנעשה בהן שימוש בפרמטר label
נוסף. באמצעות searchContacts
מהשירות המתקדם שלPeople API תוכלו להציג אנשי קשר לפי השדה המקביל, אבל אי אפשר להגביל את החיפוש לתווית ספציפית.
שיטות עם מקבילות חלקיות |
---|
|
תכונות נוספות שזמינות עםPeople API
כשעוברים לשירות המתקדם שלPeople API, אפשר לגשת לתכונות הבאות שלPeople API שלא זמינות בשירות 'אנשי קשר':
- ציון של מקור הנתונים – כשמחפשים מידע על מישהו, אפשר לציין איפה לחפש, למשל איש קשר של Google או פרופיל Google.
- חיפוש אנשים לפי מחרוזת שאילתה – מקבלים רשימה של פרופילים ואנשי קשר שתואמים למחרוזת ספציפית.
- בקשות מאצווה – ניתן לאגד קריאות ל-People API כדי לקצר את זמן הביצוע של הסקריפט.
דוגמאות קוד למשימות נפוצות
בקטע הזה מפורטות משימות נפוצות מהשירות 'אנשי קשר'. בדוגמאות הקוד מוסבר איך לבנות את המשימות באמצעות השירות המתקדם שלPeople API.
אחזר קבוצת אנשי קשר לפי שם
דוגמת הקוד הבאה מראה איך לפתוח קבוצת אנשי קשר לפי השם שלה, שהוא שווה ערך ל-getContactGroup(name)
בשירות 'אנשי קשר'.
קבלת איש קשר לפי כתובת אימייל
דוגמת הקוד הבאה מראה איך למצוא איש קשר לפי כתובת האימייל שלו, בדומה ל-getContact(emailAddress)
בשירות 'אנשי קשר'.
הורדת כל אנשי הקשר
דוגמת הקוד הבאה מראה איך להשיג את כל אנשי הקשר של משתמש, שהוא שווה ערך ל-getContacts()
בשירות 'אנשי קשר'.
הצגת השם המלא של איש קשר
דוגמת הקוד הבאה מראה איך למצוא את השם המלא של איש הקשר, המקבילה ל-getFullName()
בשירות 'אנשי קשר'.
הצגת כל מספרי הטלפון של איש קשר מסוים
דוגמת הקוד הבאה מראה איך לקבל את כל מספרי הטלפון של איש קשר, בדומה ל-getPhones()
בשירות 'אנשי קשר'.
קבלת מספר טלפון ספציפי לאיש קשר
דוגמת הקוד הבאה מראה איך לקבל מספר טלפון ספציפי לאיש קשר, בדומה ל-getPhoneNumber()
בשירות 'אנשי קשר'.