Diese Seite wurde von der Cloud Translation API übersetzt.

Freigegebene Kontakte abrufen

Sie können freigegebene Nutzerkontakte auf verschiedenen Möglichkeiten:

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

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

Alle geteilten Kontakte abrufen

Um alle freigegebenen Kontakte abzurufen, senden Sie eine HTTP-GET-Anfrage an den URL des Kontakt-Feeds:

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 angibt, gd:extendedProperty-Elemente. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte:

Der Feed gibt den Statuscode HTTP 200 OK und einen standardmäßigen Atom 1.0-Statuscode zurück. Feed mit den Kontakten. Im Folgenden finden Sie ein Beispiel für Feed 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. Bis die gesamte Kontaktliste abrufen und den zurückgegebenen Weiter, bis er im Rückgabefeed nicht mehr angezeigt wird.

Freigegebene Kontakte mithilfe von Abfrageparametern abrufen

Sie können eine Reihe von Kontakten anfordern, Kriterien wie die Anforderung von Kontakten, die nach einem bestimmten Datum aktualisiert wurden. Es gibt keine Unterstützung für Volltextanfragen oder die Suche nach einem Kontakt über die E-Mail-Adresse. Für eine Vollständige Liste der unterstützten Abfrageparameter finden Sie unter Referenzhandbuch für die Domain Shared Contacts API

HTTP GET-Anfrage mit einem definierten Wert an die URL des Kontaktfeeds senden Parameter:
```
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 angibt, gd:extendedProperty-Elemente. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte:
- PARAMETER: eine der unterstützten Abfragen Parameter. Weitere Informationen finden Sie unter Referenzhandbuch für die Domain Shared Contacts API
Um z. B. alle Einträge für die freigegebenen Kontakte der Domain abzurufen, die nach dem 16. März 2022 für beispiel.de: HTTP-Anfrage an die freigegebene Domain senden Feed-URL kontaktieren und der Anfrage-URL den Parameter updated-min hinzufügen:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Wenn du diese GET-Anfrage sendest, gibt der Server eine HTTP-200 OK zurück. und einem Feed mit allen in der Domain freigegebenen Kontakten, die zuvor die nach dem angegebenen Datum erstellt oder aktualisiert wurden.
Der Feed gibt in einer einzelnen Antwort nicht mehr als 10 MB zurück. Bis die gesamte Kontaktliste mit den angegebenen Kriterien Folgen Sie dem Link Weiter des zurückgegebenen Feeds, bis er nicht mehr angezeigt wird. im Rückgabefeed.

Inkrementelle Änderungen verfolgen

Um inkrementelle Änderungen an einer in einer Domain freigegebenen Kontaktliste nachzuverfolgen, führen Sie die Folgendes: 1. Wenn Sie eine Anfrage für einen Feed senden, erfassen Sie den Wert des Parameters <updated>-Element des Feeds. 1. Sie können nur die in der Domain freigegebenen Kontakte abrufen, die seit dem Anforderung durch Festlegen des Suchparameters updated-min auf diesen <updated>-Wert und die Einstellung showdeleted bis true.

Einzelnen gemeinsamen Kontakt abrufen

Um einen einzelnen freigegebenen Kontakt abzurufen, müssen Sie den Selbstlink des Kontakts verwenden. Sie können nur den Selbstlink des freigegebenen Kontakts abrufen, indem Sie den Eintrag des Kontakts im gemeinsamen Kontakt-Feed. Wenn Sie nicht sicher sind, welchen Wert Sie für den Self-Link verwenden sollen, Siehe Alle Kontakte abrufen und Kontakte mithilfe von Suchparametern abrufen

Senden Sie eine HTTP-GET-Anfrage, um einen bestimmten in der Domain freigegebenen Kontakt abzurufen. Anfrage zum Selbstlink eines Kontakts:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Ersetzen Sie dabei Folgendes:

DOMAIN: Die URL für Ihre Domain, z. B. beispiel.de.
PROJECTION: der Projektionswert, der die gd:extendedProperty-Elemente. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte:
SELF_LINK: Ein eindeutiger numerischer Wert, der für einen einen gemeinsamen Kontakt, z. B. 12345.

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

Um beispielsweise einen in der Domain freigegebenen Kontakt abzurufen, bei dem der Selbstlink auf https://www.google.com/m8/feeds/contacts/example.com/full/12345, sende 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 abrufen