Freigegebene Kontakte abrufen

Sie können freigegebene Nutzerkontakte auf folgende Weise anfordern:

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

Einträge in einem Feed sind standardmäßig ungeordnet.

Alle freigegebenen Kontakte abrufen

  1. Wenn Sie alle freigegebenen Kontakte abrufen möchten, senden Sie eine HTTP-GET-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. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte.

    Der Server gibt einen HTTP 200 OK-Statuscode und einen Atom 1.0-Feed zurück. Das folgende Beispiel zeigt einen Kontakte-Feed 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 im zurückgegebenen Feed wiederholt dem Link Next.

Freigegebene Kontakte mit Abfrageparametern abrufen

Kontakte anfordern, 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 in der Domain Shared Contacts API-Referenz.

  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 für example.com abrufen möchten, die nach dem 16. März 2022 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 einen HTTP 200 OK-Statuscode 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 im zurückgegebenen Feed wiederholt dem Link Next.

Inkrementelle Änderungen nachverfolgen

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

Einzelnen freigegebenen Kontakt abrufen

Wenn Sie einen bestimmten Kontakt abrufen möchten, verwenden Sie den Self-Link des Kontakts, den Sie im Feed für freigegebene 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 Self-Link 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. Informationen zu unterstützten Werten finden Sie unter Projektionswerte.
  • SELF_LINK: Der eindeutige numerische Wert des Kontakts.

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

Um beispielsweise einen Kontakt mit dem Self-Link https://www.google.com/m8/feeds/contacts/example.com/full/12345 abzurufen:

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

Nächste Schritte