קבלת אנשי קשר משותפים

תוכלו לבקש אנשי קשר משותפים של המשתמש במגוון דרכים:

• כל אנשי הקשר המשותפים
• קבוצה של אנשי קשר שתואמים לקריטריונים מסוימים
• איש קשר משותף אחד
• תמונה של איש קשר

כברירת מחדל, הערכים בפיד לא מסודרים.

קבלת כל אנשי הקשר המשותפים

1. כדי לקבל את כל אנשי הקשר המשותפים, צריך לשלוח בקשת HTTP GET לכתובת ה-URL של פיד אנשי הקשר:

   GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION
   

   מחליפים את מה שכתוב בשדות הבאים:

   • DOMAIN: כתובת האתר של הדומיין שלכם — לדוגמה, example.com.
   • PROJECTION: ערך ההיטל שמציין את רכיבי gd:extendedProperty. בערכי ההקרנה תוכלו לראות רשימה של הערכים הנתמכים.

   הפיד מחזיר את קוד הסטטוס HTTP 200 OK ופיד סטנדרטי של Atom 1.0 שמכיל את אנשי הקשר. הדוגמה הבאה היא של פיד אנשי קשר שמכיל רשומה אחת בלבד:

   <feed xmlns='http://www.w3.org/2005/Atom'
       xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
       xmlns:gd='http://schemas.google.com/g/2005'
       xmlns:gContact='http://schemas.google.com/contact/2008'
       xmlns:batch='http://schemas.google.com/gdata/batch'>
     <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
     <updated>2008-03-05T12:36:38.836Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>example.com's Contacts</title>
     <link rel='http://schemas.google.com/g/2005#feed'
       type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full' />
     <link rel='http://schemas.google.com/g/2005#post'
       type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full' />
     <link rel='http://schemas.google.com/g/2005#batch'
       type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
     <author>
       <name>example.com</name>
       <email>example.com</email>
     </author>
     <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
       Contacts
     </generator>
     <openSearch:totalResults>1</openSearch:totalResults>
     <openSearch:startIndex>1</openSearch:startIndex>
     <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
     <entry>
       <id>
         https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
       </id>
       <updated>2008-03-05T12:36:38.835Z</updated>
       <category scheme='http://schemas.google.com/g/2005#kind'
         term='http://schemas.google.com/contact/2008#contact' />
       <title type='text'>Fitzgerald</title>
       <gd:name>
         <gd:fullName>Fitzgerald</gd:fullName>
       </gd:name>
       <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
         href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
       <link rel='self' type='application/atom+xml'
         href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
       <link rel='edit' type='application/atom+xml'
         href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
       <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
         primary='true'>
         456
       </gd:phoneNumber>
       <gd:extendedProperty name="pet" value="hamster" />
     </entry>
   </feed>
   

2. הפיד לא מחזיר יותר מ-10MB בתגובה אחת. כדי לפתוח את הרשימה המלאה של אנשי הקשר, לוחצים שוב ושוב על הקישור Next בפיד שהוחזר עד שהקישור הזה לא מופיע יותר.

אחזר אנשי קשר משותפים באמצעות פרמטרים של שאילתות

תוכלו לבקש קבוצה של אנשי קשר שתואמים לקריטריונים מסוימים, למשל לבקש אנשי קשר שיעודכנו אחרי תאריך מסוים. אין תמיכה בשאילתות טקסט מלא או באיתור איש קשר לפי כתובת אימייל. במדריך ל-Domain Shared Contacts API מופיעה רשימה מלאה של הפרמטרים הנתמכים של שאילתות.

1. שולחים בקשת HTTP GET לכתובת ה-URL של פיד אנשי הקשר עם פרמטר מוגדר:

   GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
   

   מחליפים את מה שכתוב בשדות הבאים:

   • DOMAIN: כתובת האתר של הדומיין שלכם — לדוגמה, example.com.
   • PROJECTION: ערך ההיטל שמציין את רכיבי gd:extendedProperty. בערכי ההקרנה תוכלו לראות רשימה של הערכים הנתמכים.
   • PARAMETER: אחד מהפרמטרים הנתמכים של שאילתות. למידע נוסף, קראו את המדריך ל-Domain Shared Contacts API.

   לדוגמה, כדי לעדכן את כל הרשומות של אנשי הקשר ששותפו מהדומיין אחרי 16 במרץ 2022 עבור example.com, צריך לשלוח בקשת HTTP לדומיין המשותף של כתובת ה-URL של פיד אנשי הקשר ולהוסיף את הפרמטר updated-min לכתובת ה-URL של הבקשה:

   GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
   

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

2. הפיד לא מחזיר יותר מ-10MB בתגובה אחת. כדי לפתוח את הרשימה המלאה של אנשי הקשר עם הקריטריונים שצוינו, צריך ללחוץ שוב ושוב על הקישור Next בפיד שהוחזר, עד שהקישור הזה לא יופיע יותר בפיד ההחזרה.

מעקב אחר שינויים מצטברים

כדי לעקוב אחרי שינויים מצטברים ברשימת אנשי קשר משותפת בדומיין: 1. כששולחים בקשה בפיד, צריך לעקוב אחר ערך הרכיב <updated> של הפיד. 1. כדי לקבל רק את אנשי הקשר ששותפו מהדומיין אבל השתנו מאז הבקשה הקודמת, אפשר להגדיר לפרמטר השאילתה updated-min את הערך <updated> ולהגדיר את showdeleted לערך true.

קבלת איש קשר משותף אחד

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

1. כדי להגדיר איש קשר ספציפי בדומיין, צריך לשלוח בקשת HTTP GET לקישור העצמי של איש הקשר:

   GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
   

   מחליפים את מה שכתוב בשדות הבאים:

• DOMAIN: כתובת האתר של הדומיין שלכם — לדוגמה, example.com.
• PROJECTION: ערך ההיטל שמציין את רכיבי gd:extendedProperty. בערכי ההקרנה תוכלו לראות רשימה של הערכים הנתמכים.
• SELF_LINK: ערך מספרי ייחודי שמייצג איש קשר משותף אחד – לדוגמה 12345.

לאחר מכן השרת מחזיר קוד מצב HTTP 200 OK ורשומה שמכילה את איש הקשר.

לדוגמה, כדי לקבל איש קשר משותף בדומיין עם הקישור העצמי המוגדר ל-https://www.google.com/m8/feeds/contacts/example.com/full/12345, צריך לשלוח את בקשת ה-HTTP הבאה:

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

השלבים הבאים

• איך מוצאים תמונה של איש קשר משותף?