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

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

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

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

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

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

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

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

‫DOMAIN: הדומיין שלכם. לדוגמה, example.com.
‫PROJECTION: ערך התחזית. לרשימת ערכים נתמכים, ראו ערכי הקרנה.

השרת מחזיר קוד סטטוס 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>

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

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

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

שליחת בקשת HTTP GET לכתובת ה-URL של פיד אנשי הקשר עם פרמטר:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫DOMAIN: הדומיין שלכם – לדוגמה, example.com.
- ‫PROJECTION: ערך התחזית. לרשימת ערכים נתמכים, ראו ערכי הקרנה.
- ‫PARAMETER: פרמטר נתמך של שאילתה. מידע נוסף זמין במדריך ההפניה של Domain Shared Contacts API.
לדוגמה, כדי לקבל רשומות שעדכנו אחרי 16 במרץ 2022 עבור example.com, מוסיפים את הפרמטר updated-min:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
השרת מחזיר קוד סטטוס HTTP 200 OK ופיד עם כל ההתאמות.
הפידים מחזירים עד 10MB בתשובה אחת. כדי לקבל את הרשימה המלאה, צריך ללחוץ שוב ושוב על הקישור הבא בפיד שמוחזר.

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

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

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

כדי לקבל איש קשר ספציפי, משתמשים בקישור העצמי של איש הקשר, שאפשר למצוא בפיד של אנשי הקשר המשותפים. מידע נוסף זמין במאמר בנושא קבלת כל אנשי הקשר ששותפו.

כדי לקבל פרטים של איש קשר ספציפי, שולחים בקשת HTTP GET לקישור העצמי של איש הקשר:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
```
מחליפים את מה שכתוב בשדות הבאים:

‫DOMAIN: הדומיין שלכם – לדוגמה, example.com.
‫PROJECTION: ערך התחזית. לרשימת ערכים נתמכים, ראו ערכי הקרנה.
‫SELF_LINK: הערך המספרי הייחודי של איש הקשר.

השרת מחזיר קוד סטטוס HTTP 200 OK ואת רשומת איש הקשר.

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

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

השלבים הבאים

איך מוסיפים תמונה לאיש קשר משותף

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