Freigegebene Kontakte abrufen

So fordern Sie freigegebene Nutzerkontakte an:

  • Alle freigegebenen Kontakte
  • Eine Reihe von Kontakten, die bestimmten Kriterien entsprechen
  • Ein einzelner freigegebener Kontakt
  • Ein Foto für einen Kontakt

Standardmäßig sind die Einträge in einem Feed ungeordnet.

Alle freigegebenen Kontakte abrufen

  1. Wenn Sie alle freigegebenen Kontakte abrufen möchten, senden Sie eine GET-HTTP-Anfrage an die URL des Kontaktfeeds:

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

    Ersetzen Sie Folgendes:

    • DOMAIN: Ihre Domain Beispiel: beispiel.de
    • PROJECTION: Der Projektionswert Unterstützte Werte finden Sie unter Projektionswerte.

    Der Server gibt den Statuscode HTTP 200 OK und einen Atom 1.0-Feed zurück. Das folgende Beispiel zeigt einen Kontaktfeed mit einem Eintrag:

    <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. Feeds geben maximal 10 MB in einer einzelnen Antwort zurück. Wenn Sie die gesamte Liste abrufen möchten, folgen Sie wiederholt dem Link Weiter im zurückgegebenen Feed.

Freigegebene Kontakte mithilfe von Abfrageparametern abrufen

Fordern Sie Kontakte an, die bestimmten Kriterien entsprechen, z. B. Kontakte, die nach einem bestimmten Datum aktualisiert wurden. Volltextabfragen und E‑Mail-Adressensuchen werden nicht unterstützt. Alle Abfrageparameter finden Sie im Referenzleitfaden zur Domain Shared Contacts API.

  1. Senden Sie eine HTTP GET-Anfrage an die URL des Kontaktfeeds mit einem Parameter:

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

    Ersetzen Sie Folgendes:

    Wenn Sie beispielsweise Einträge abrufen möchten, die nach dem 16. März 2022 für beispiel.de aktualisiert wurden, fügen Sie den Parameter updated-min hinzu:

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

    Der Server gibt den Statuscode HTTP 200 OK und einen Feed mit allen Übereinstimmungen zurück.

  2. Feeds geben maximal 10 MB in einer einzelnen Antwort zurück. Wenn Sie die gesamte Liste abrufen möchten, folgen Sie wiederholt dem Link Weiter im zurückgegebenen Feed.

Inkrementelle Änderungen nachverfolgen

So verfolgen Sie Änderungen an einer freigegebenen Kontaktliste einer Domain: 1. Notieren Sie sich den Wert des <updated>-Elements des Feeds. 1. Fordern Sie geänderte Kontakte an, indem Sie updated-min auf diesen <updated> Wert und showdeleted auf true festlegen.

Einen einzelnen freigegebenen Kontakt abrufen

Wenn Sie einen bestimmten Kontakt abrufen möchten, verwenden Sie den Link „Selbst“ des Kontakts, den Sie im Feed der freigegebenen Kontakte finden. Weitere Informationen finden Sie unter Alle freigegebenen Kontakte abrufen.

  1. Wenn Sie einen bestimmten Kontakt abrufen möchten, senden Sie eine HTTP GET Anfrage an den Link „Selbst“ des Kontakts: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Ersetzen Sie Folgendes:
  • DOMAIN: Ihre Domain, z. B. beispiel.de
  • PROJECTION: Der Projektionswert Unterstützte Werte finden Sie unter Projektionswerte.
  • SELF_LINK: Der eindeutige numerische Wert des Kontakts

Der Server gibt den Statuscode HTTP 200 OK und den Kontakteintrag zurück.

Beispiel: So rufen Sie einen Kontakt mit dem Link „Selbst“ ab: https://www.google.com/m8/feeds/contacts/example.com/full/12345

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

Nächste Schritte