Diese Seite wurde von der Cloud Translation API übersetzt.

Freigegebene Kontakte abrufen

Es gibt mehrere Möglichkeiten, freigegebene Nutzerkontakte anzufordern:

Alle freigegebenen Kontakte
Eine Gruppe von Kontakten, die ein bestimmtes Kriterium erfüllen.
Ein einziger gemeinsamer Kontakt
Foto für einen Kontakt

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

Alle freigegebenen Kontakte abrufen

Wenn Sie alle gemeinsamen Kontakte abrufen möchten, senden Sie eine HTTP-GET-Anfrage an die Kontaktfeed-URL:

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

Ersetzen Sie Folgendes:

DOMAIN: Die URL für Ihre 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 HTTP 200 OK-Statuscode und einen Atom 1.0-Standardfeed mit den Kontakten zurück. Das folgende Beispiel zeigt einen Kontaktfeed 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, folgen Sie dem Link Weiter des zurückgegebenen Feeds so lange, bis dieser Link nicht mehr im Rückgabefeed angezeigt wird.

Gemeinsame Kontakte mithilfe von Suchparametern abrufen

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

Senden Sie eine HTTP GET-Anfrage mit einem definierten Parameter an die Kontaktfeed-URL:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Ersetzen Sie Folgendes:
- DOMAIN: Die URL für Ihre 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 zur Domain Shared Contacts API.
Wenn Sie beispielsweise alle Einträge für freigegebene Domainkontakte (beispiel.de) nach dem 16. März 2022 aktualisieren möchten, senden Sie eine HTTP-Anfrage an die Feed-URL des freigegebenen Kontakts der Domain 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 den HTTP-Statuscode 200 OK und einen Feed mit allen gemeinsamen Domainkontakten 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. Folgen Sie dem Link Weiter des zurückgegebenen Feeds wiederholt, um die gesamte Kontaktliste mit den angegebenen Kriterien abzurufen, bis dieser Link nicht mehr im Rückgabefeed angezeigt wird.

Inkrementelle Änderungen erfassen

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

Einzelnen gemeinsamen Kontakt abrufen

Wenn Sie einen einzelnen gemeinsamen Kontakt abrufen möchten, müssen Sie den Self-Link des Kontakts verwenden. Sie können den Self-Link des freigegebenen Kontakts nur abrufen, indem Sie den Eintrag des Kontakts im Feed der freigegebenen Kontakte suchen. Wenn Sie nicht sicher sind, welcher Wert für den Self-Link verwendet werden soll, lesen Sie Alle Kontakte abrufen und Kontakte mithilfe von Abfrageparametern abrufen.

Wenn Sie einen bestimmten freigegebenen Kontakt in der Domain abrufen möchten, senden Sie eine HTTP-GET-Anfrage an den Self-Link eines Kontakts:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Ersetzen Sie Folgendes:

DOMAIN: Die URL für Ihre 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 gemeinsamen 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 freigegebenen Kontakt in der Domain abrufen möchten, dessen Self-Link auf https://www.google.com/m8/feeds/contacts/example.com/full/12345 gesetzt ist, 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 gemeinsamen Kontakt erhalten