Diese Seite wurde von der Cloud Translation API übersetzt.

Freigegebene Kontakte abrufen

Sie haben verschiedene Möglichkeiten, Kontakte von anderen Nutzern anzufordern:

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

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

Alle freigegebenen Kontakte abrufen

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

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

Ersetzen Sie Folgendes:

DOMAIN: Die URL Ihrer Domain, z. B. beispiel.de.
PROJECTION: Der Projektionswert, der die gd:extendedProperty-Elemente angibt. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte.

Der Feed gibt einen Statuscode HTTP 200 OK und einen Standard-Atom 1.0-Feed mit den Kontakten zurück. Im folgenden Beispiel sehen Sie einen Kontaktefeed mit nur 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>

Der Feed gibt in einer einzelnen Antwort nicht mehr als 10 MB zurück. Wenn Sie die gesamte Kontaktliste abrufen möchten, klicken Sie im zurückgegebenen Feed so oft auf den Link Weiter, bis dieser Link nicht mehr angezeigt wird.

Freigegebene Kontakte mithilfe von Abfrageparametern abrufen

Sie können eine Reihe von Kontakten anfordern, die bestimmten Kriterien entsprechen, z. B. Kontakte, die nach einem bestimmten Datum aktualisiert wurden. Volltextabfragen und die Suche nach einem Kontakt anhand der E-Mail-Adresse werden nicht unterstützt. Eine vollständige Liste der unterstützten Abfrageparameter finden Sie im Referenzhandbuch für die Domain Shared Contacts API.

Senden Sie eine HTTP GET-Anfrage an die URL des Kontaktefeeds mit einem definierten Parameter:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Ersetzen Sie Folgendes:
- DOMAIN: Die URL Ihrer Domain, z. B. beispiel.de.
- PROJECTION: Der Projektionswert, der die gd:extendedProperty-Elemente angibt. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte.
- PARAMETER: Einer der unterstützten Abfrageparameter. Weitere Informationen finden Sie im Referenzhandbuch für die Domain Shared Contacts API.
Wenn Sie beispielsweise alle domaingemeinsamen Kontaktdateneinträge nach dem 16. März 2022 für beispiel.de aktualisieren möchten, senden Sie eine HTTP-Anfrage an die URL des domaingemeinsamen Kontaktdatenfeeds und fügen Sie der Anfrage-URL den Parameter updated-min hinzu:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Wenn Sie diese GET-Anfrage senden, gibt der Server einen HTTP-200 OK-Statuscode und einen Feed mit allen Domain-freigegebenen Kontakten zurück, die nach dem angegebenen Datum erstellt oder aktualisiert wurden.
Der Feed gibt in einer einzelnen Antwort nicht mehr als 10 MB zurück. Wenn Sie die gesamte Kontaktliste mit den angegebenen Kriterien abrufen möchten, klicken Sie im zurückgegebenen Feed so oft auf den Link Weiter, bis dieser Link nicht mehr angezeigt wird.

Inkrementelle Änderungen verfolgen

So können Sie inkrementelle Änderungen an einer freigegebenen Kontaktliste einer Domain im Blick behalten: 1. Wenn Sie eine Anfrage für einen Feed senden, notieren Sie sich den Wert des <updated>-Elements des Feeds. 1. Sie können nur die Domain-freigegebenen Kontakte abrufen, die sich seit der vorherigen Anfrage geändert haben. Dazu müssen Sie den Abfrageparameter updated-min auf den Wert <updated> und showdeleted auf true festlegen.

Einzelnen freigegebenen Kontakt abrufen

Wenn Sie einen einzelnen geteilten Kontakt abrufen möchten, müssen Sie den Link zum Kontakt selbst verwenden. Sie können den Link zum geteilten Kontakt nur abrufen, wenn Sie den Eintrag des Kontakts im Feed mit geteilten Kontakten finden. Wenn Sie sich nicht sicher sind, welchen Wert Sie für den Link zum Selbst verweis verwenden sollen, lesen Sie die Hilfeartikel Alle Kontakte abrufen und Kontakte mithilfe von Suchparametern abrufen.

Wenn Sie einen bestimmten für eine Domain freigegebenen Kontakt abrufen möchten, senden Sie eine HTTP-GET-Anfrage an den Link zum Kontakt selbst:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Ersetzen Sie Folgendes:

DOMAIN: Die URL Ihrer Domain, z. B. beispiel.de.
PROJECTION: Der Projektionswert, der die gd:extendedProperty-Elemente angibt. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte.
SELF_LINK: Ein eindeutiger numerischer Wert, der einen einzelnen freigegebenen Kontakt darstellt, z. B. 12345.

Der Server gibt dann den HTTP-Statuscode 200 OK und einen Eintrag mit dem Kontakt zurück.

Wenn Sie beispielsweise einen Domain-freigegebenen Kontakt mit dem selbstverlinkten https://www.google.com/m8/feeds/contacts/example.com/full/12345 abrufen möchten, senden Sie die folgende HTTP-Anfrage:

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

Nächste Schritte

Foto für einen freigegebenen Kontakt abrufen