Freigegebene Kontakte erstellen

Nachdem Sie die Authentifizierung eingerichtet haben, können Sie mit der Domain Shared Contacts API neue freigegebene Kontakteinträge in einer Google Workspace-Domain veröffentlichen. Es kann bis zu 24 Stunden dauern, bis freigegebene Kontakte in der automatischen Vervollständigung und im Kontaktmanager angezeigt werden.

  1. Erstellen Sie eine XML-Darstellung des freigegebenen Kontakts, die als Atom-Element <entry> des Kontakttyps veröffentlicht werden soll:

    <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'>
  <atom:category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <gd:name>
     <gd:givenName>FIRST_NAME</gd:givenName>
     <gd:familyName>LAST_NAME</gd:familyName>
     <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <atom:content type='text'>NOTES</atom:content>
  <gd:email rel='http://schemas.google.com/g/2005#work'
    primary='true'
    address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
  <gd:email rel='http://schemas.google.com/g/2005#home'
    address='SECONDARY_EMAIL_ADDRESS' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
    primary='true'>
    PRIMARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    SECONDARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:im address='INSTANT_MESSAGING_ADDRESS'
    protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
    primary='true'
    rel='http://schemas.google.com/g/2005#home' />
  <gd:structuredPostalAddress
      rel='http://schemas.google.com/g/2005#work'
      primary='true'>
    <gd:city>CITY_NAME</gd:city>
    <gd:street>ADDRESS</gd:street>
    <gd:region>REGION_NAME</gd:region>
    <gd:postcode>POST_CODE</gd:postcode>
    <gd:country>COUNTRY_NAME</gd:country>
    <gd:formattedAddress>
      FORMATTED_ADDRESS
    </gd:formattedAddress>
  </gd:structuredPostalAddress>
</atom:entry>

    Ersetzen Sie Folgendes:

    • FIRST_NAME: Der Vorname des Kontakts, z. B. Dana.
    • LAST_NAME: Der Nachname des Kontakts, z. B. A.
    • PRIMARY_EMAIL_ADDRESS: Bevorzugte E-Mail-Adresse, z. B. dana@beispiel.de.
    • PREFERRED_NAME: Anzeigename für den Nutzer, z. B. Dana A.
    • SECONDARY_EMAIL_ADDRESS: Sekundäre E-Mail-Adresse, z. B. da@beispiel.de.
    • PRIMARY_PHONE_NUMBER: Bevorzugte Telefonnummer, z. B. 800-555-0100.
    • SECONDARY_PHONE_NUMBER: Sekundäre Telefonnummer, z. B. 800-555-0101.
    • INSTANT_MESSAGING_ADDRESS: E-Mail-Adresse für Instant Messaging, z. B. dana@beispiel.de.
    • CITY_NAME: Name der Stadt, z. B. Mountain View.
    • ADDRESS: Adresse, z. B. 1800 Amphibious Blvd.
    • REGION_NAME: Bundesland oder Provinz, z. B. CA.
    • POST_CODE: Postleitzahl, z. B. 94045.
    • COUNTRY_NAME: Land, z. B. USA.
    • FORMATTED_ADDRESS: Adresse, die gemäß lokalen Konventionen formatiert ist, z. B. 1800 Amphibious Blvd. Mountain View, CA 94045, USA.

  2. Wenn Sie diesen Eintrag veröffentlichen möchten, senden Sie ihn an die Feed-URL der Kontaktliste:

    1. Fügen Sie das Atom-Element <entry> in den Text einer neuen POST-Anfrage ein. Verwenden Sie dazu den Inhaltstyp application/atom+xml.
    2. Senden Sie die POST-Anfrage an die Feed-URL.

    Wenn Sie beispielsweise einen Kontakt zur Liste „beispiel.de“ hinzufügen möchten, senden Sie die POST-Anfrage an die folgende URL:

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

    Der Server erstellt den Kontakt und gibt einen HTTP 201 CREATED-Statuscode zusammen mit dem neuen Kontakteintrag zurück. Der zurückgegebene Eintrag enthält vom Server generierte Elemente wie <id>.

    Wenn die Anfrage fehlschlägt, gibt der Server einen anderen Statuscode zurück. Weitere Informationen finden Sie in der Google Data API-Protokollreferenz.

Nächste Schritte