Freigegebene Kontakte erstellen

Nach dem Einrichten der Authentifizierung 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 von E-Mail-Adressen und im Kontaktmanager angezeigt werden.

1. Erstellen Sie eine XML-Darstellung des gemeinsamen Kontakts, den Sie veröffentlichen möchten, in Form eines Atom-Elements <entry> der Kontaktart, das etwa so aussieht:

   <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: Vorname des gemeinsamen Kontakts, z. B. Alex.
   • LAST_NAME: Der Nachname des gemeinsamen Kontakts, z. B. Kim.
   • PRIMARY_EMAIL_ADDRESS: Die bevorzugte E-Mail-Adresse des gemeinsamen Kontakts, z. B. [e-mail].
   • PREFERRED_NAME: Der Name, der dem Nutzer angezeigt wird, z. B. Alex Kim.
   • SECONDARY_EMAIL_ADDRESS: Eine andere E-Mail-Adresse für den gemeinsamen Kontakt, z. B. [e-mail].
   • PRIMARY_PHONE_NUMBER: Die bevorzugte Telefonnummer für den gemeinsamen Kontakt, z. B. [phone].
   • SECONDARY_PHONE_NUMBER: Eine andere Telefonnummer für den gemeinsamen Kontakt, z. B. [phone].
   • INSTANT_MESSAGING_ADDRESS: Die E-Mail-Adresse, die mit den Instant-Messaging-Informationen des gemeinsamen Kontakts verknüpft ist, z. B. [e-mail].
   • CITY_NAME: Der Name der Stadt für den gemeinsamen Kontakt, z. B. Mountain View.
   • ADDRESS: Die Adresse des gemeinsamen Kontakts, z. B. 1600 Amphibious Blvd.
   • REGION_NAME: Der Bundesstaat oder die Provinz für den freigegebenen Kontakt, z. B. CA.
   • POST_CODE: Die Postleitzahl des gemeinsamen Kontakts, z. B. 94045.
   • COUNTRY_NAME: Land für den gemeinsamen Kontakt, z. B. USA.
   • FORMATTED_ADDRESS: Die Adresse des gemeinsamen Kontakts, die gemäß der Konvention des Landes oder der Region formatiert ist, z. B. 1800 Amphibious Blvd Mountain View.

2. Um diesen Eintrag zu veröffentlichen, 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 freigegebenen Kontakt in der Domain der Liste hinzufügen möchten, die zu „example.com“ gehört, senden Sie die Anfrage POST mit dem neuen Eintrag an die folgende URL:

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

   Der Google-Server erstellt mithilfe des von Ihnen gesendeten Eintrags einen Kontakt und gibt dann den Statuscode HTTP 201 CREATED sowie eine Kopie des neuen Kontakts im Format eines <entry>-Elements zurück. Der zurückgegebene Eintrag ist derselbe, den Sie gesendet haben, enthält aber auch verschiedene vom Server hinzugefügte Elemente, z. B. ein <id>-Element.

   Wenn Ihre Anfrage fehlschlägt, gibt Google möglicherweise einen anderen Statuscode zurück. Informationen zu den Statuscodes finden Sie im Referenzdokument zum Google Data API-Protokoll.

Nächste Schritte

• Fotos für einen gemeinsamen Kontakt aktualisieren oder löschen