Gemeinsamen Kontakt aktualisieren oder löschen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Das Aktualisieren oder Löschen eines freigegebenen Kontakts funktioniert ähnlich.
Wenn Sie einen Eintrag aktualisieren, müssen Sie alle XML-Elemente beibehalten, die beim Abrufen des Eintrags vom Server vorhanden waren. Andernfalls werden die ignorierten Elemente gelöscht. Es kann bis zu 24 Stunden dauern, bis die Änderungen in der automatischen Vervollständigung von E-Mail-Adressen und im Kontaktmanager angezeigt werden.
So aktualisieren Sie einen vorhandenen freigegebenen Kontakt:
- Holen Sie den Eintrag ab, den Sie aktualisieren möchten.
- Bearbeiten Sie den Eintrag.
Senden Sie eine PUT
-Anfrage mit dem aktualisierten Eintrag im Nachrichtentext an die Bearbeitungs-URL des Kontakts. Verwenden Sie den Inhaltstyp application/atom+xml
und achten Sie darauf, dass der <id>
-Wert im aktualisierten Eintrag genau mit dem <id>
des vorhandenen Eintrags übereinstimmt. Die Bearbeitungs-URL endet mit einer Versionsnummer, um Konflikte bei Updates aus verschiedenen Quellen zu erkennen. Weitere Informationen finden Sie unter Versionsverwaltung.
Aktualisieren Sie den Eintrag:
<entry>
<id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
<updated>2008-02-28T18:47:02.303Z</updated>
<category scheme='http://schemas.google.com/g/2005#kind'
term='http://schemas.google.com/contact/2008#contact' />
<title type='text'>TITLE_NAME</title>
<gd:name>
<gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
</gd:name>
<content type='text'>NOTES</content>
<link rel='self' type='application/atom+xml'
href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
<link rel='edit' type='application/atom+xml'
href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
<gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
<gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
</entry>
Ersetzen Sie Folgendes:
DOMAIN
: Die URL Ihrer Domain, z. B. beispiel.de.
TITLE_NAME
: Ein Name für den Kontakteintrag, z. B. „beispiel.de-Kontaktliste“.
FIRST_NAME
: Der Vorname des freigegebenen Kontakts, z. B. Alex.
LAST_NAME
: Der Nachname des freigegebenen Kontakts, z. B. Kim.
PROJECTION
: Der Projektionswert, der die gd:extendedProperty
-Elemente angibt. Eine Liste der unterstützten Werte finden Sie unter Projektionswerte.
PRIMARY_PHONE_NUMBER
: Die bevorzugte Telefonnummer für den freigegebenen Kontakt, z. B. (206)555-1212.
CUSTOM_PROPERTY
: Ein Name für eine benutzerdefinierte Property, die Sie für den freigegebenen Kontakt speichern möchten, z. B. „Haustier“.
CUSTOM_PROPRTY_VALUE
: Ein Wert für eine benutzerdefinierte Property, die Sie für den freigegebenen Kontakt speichern möchten, z. B. „Hamster“.
Im folgenden Beispiel ist ein aktualisierter Eintrag für einen freigegebenen Kontakt zu sehen, wobei die URL zum Bearbeiten hervorgehoben ist:
<entry>
<id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
<updated>2008-02-28T18:47:02.303Z</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>
<content type='text'>Notes</content>
<link rel='self' type='application/atom+xml'
href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
<link rel='edit' type='application/atom+xml'
href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
<gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
primary='true'>456-123-2133</gd:phoneNumber>
<gd:extendedProperty name="pet" value="hamster" />
<gd:extendedProperty name="cuisine">
<italian />
</gd:extendedProperty>
</entry>
Es kann bis zu 24 Stunden dauern, bis gelöschte freigegebene Kontakte aus der automatischen Vervollständigung von E-Mail-Adressen und dem Kontaktmanager verschwinden. Informationen zum Aktualisieren vorhandener Kontakte finden Sie unter Kontakte aktualisieren.
Aktualisieren Sie Kontakte nicht, indem Sie sie löschen und dann wieder hinzufügen.
- Wenn Sie einen freigegebenen Kontakt löschen möchten, senden Sie eine
DELETE
-Anfrage an die Bearbeitungs-URL des Kontakts. Das ist dieselbe URL, die auch zum Aktualisieren von Kontakten verwendet wird.
Google speichert Platzhalter für gelöschte Kontakte 30 Tage nach dem Löschen.
In dieser Zeit können Sie die Platzhalter mit dem Abfrageparameter showdeleted
anfordern.
Nächste Schritte
Foto für einen geteilten Kontakt aktualisieren oder löschen
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-03-25 (UTC)."],[],[],null,["# Update or delete a shared contact\n\nThe processes to update or delete a shared contact are similar.\n\nUpdate a shared contact\n-----------------------\n\nWhen you update an entry, you must preserve *all* the XML that was present when\nyou retrieved the entry from the server. Otherwise the ignored elements are\ndeleted. Updates can take up to 24 hours to be reflected in the email address\nauto-complete and the contact manager.\n\nTo update an existing shared contact, do the following:\n\n1. [Get the entry that you want to update](/workspace/admin/domain-shared-contacts/get-shared-contacts).\n2. Edit the entry.\n3. Send a `PUT` request with the updated entry in the message body to the\n contact's edit URL. Use the `application/atom+xml` content type and make\n sure that the `\u003cid\u003e` value in the updated entry exactly matches the `\u003cid\u003e`\n of the existing entry. The edit URL ends with a version number, in order to\n detect conflicts of updates from different sources. For more information,\n see\n [versioning](https://developers.google.com/gdata/docs/1.0/reference#Optimistic-concurrency).\n\n Update the entry: \n\n ```xml\n \u003centry\u003e\n \u003cid\u003ehttps://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573\u003c/id\u003e\n \u003cupdated\u003e2008-02-28T18:47:02.303Z\u003c/updated\u003e\n \u003ccategory scheme='http://schemas.google.com/g/2005#kind'\n term='http://schemas.google.com/contact/2008#contact' /\u003e\n \u003ctitle type='text'\u003eTITLE_NAME\u003c/title\u003e\n \u003cgd:name\u003e\n \u003cgd:fullName\u003eFIRST_NAME LAST_NAME\u003c/gd:fullName\u003e\n \u003c/gd:name\u003e\n \u003ccontent type='text'\u003eNOTES\u003c/content\u003e\n \u003clink rel='self' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' /\u003e\n \u003clink rel='edit' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' /\u003e\n \u003cgd:phoneNumber rel='http://schemas.google.com/g/2005#other'\n primary='true'\u003ePRIMARY_PHONE_NUMBER\u003c/gd:phoneNumber\u003e\n \u003cgd:extendedProperty name=\"CUSTOM_PROPERTY\" value=\"CUSTOM_PROPRTY_VALUE\" /\u003e\n \u003c/entry\u003e\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eDOMAIN\u003c/var\u003e: The URL for your domain---for example, example.com.\n - \u003cvar translate=\"no\"\u003eTITLE_NAME\u003c/var\u003e: A name for the contact entry---for example, example.com contact list.\n - \u003cvar translate=\"no\"\u003eFIRST_NAME\u003c/var\u003e: The first name of the shared contact---for example, Alex.\n - \u003cvar translate=\"no\"\u003eLAST_NAME\u003c/var\u003e: The last name of the shared contact---for example, Kim.\n - \u003cvar translate=\"no\"\u003ePROJECTION\u003c/var\u003e: The projection value that specifies the `gd:extendedProperty` elements. For a list of supported values, see [Projection values](/workspace/admin/domain-shared-contacts/extended-properties-projections#projection_values).\n - \u003cvar translate=\"no\"\u003ePRIMARY_PHONE_NUMBER\u003c/var\u003e: The preferred phone number for the shared contact---for example, (206)555-1212.\n - \u003cvar translate=\"no\"\u003eCUSTOM_PROPERTY\u003c/var\u003e: A name for a custom property that you want to store about the shared contact---for example, pet.\n - \u003cvar translate=\"no\"\u003eCUSTOM_PROPRTY_VALUE\u003c/var\u003e: A value for a custom\n property that you want to store about the shared contact---for example,\n hamster.\n\n The following is an example of an updated entry for a shared contact with\n the edit URL highlighted: \n\n ```xml\n \u003centry\u003e\n \u003cid\u003ehttps://www.google.com/m8/feeds/contacts/example.com/base/8411573\u003c/id\u003e\n \u003cupdated\u003e2008-02-28T18:47:02.303Z\u003c/updated\u003e\n \u003ccategory scheme='http://schemas.google.com/g/2005#kind'\n term='http://schemas.google.com/contact/2008#contact' /\u003e\n \u003ctitle type='text'\u003eFitzgerald\u003c/title\u003e\n \u003cgd:name\u003e\n \u003cgd:fullName\u003eFitzgerald\u003c/gd:fullName\u003e\n \u003c/gd:name\u003e\n \u003ccontent type='text'\u003eNotes\u003c/content\u003e\n \u003clink rel='self' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' /\u003e\n \u003clink rel='edit' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' /\u003e\n \u003cgd:phoneNumber rel='http://schemas.google.com/g/2005#other'\n primary='true'\u003e456-123-2133\u003c/gd:phoneNumber\u003e\n \u003cgd:extendedProperty name=\"pet\" value=\"hamster\" /\u003e\n \u003cgd:extendedProperty name=\"cuisine\"\u003e\n \u003citalian /\u003e\n \u003c/gd:extendedProperty\u003e\n \u003c/entry\u003e\n ```\n\nDelete shared contacts\n----------------------\n\nDeleted shared contacts can take up to 24 hours to disappear from the email\naddress autocomplete and the contact manager. To update existing contacts, see\n[Updating contacts](#update_a_shared_contact).\nDon't update contacts by deleting contacts and then re-adding them.\n\n- To delete a shared contact, send a `DELETE` request to the contact's edit URL. This is the same URL used to [update contacts](#update_a_shared_contact).\n\nGoogle retains placeholders for deleted contacts for 30 days after deletion.\nDuring that time, you can request the placeholders by using the `showdeleted`\nquery parameter.\n\nNext steps\n----------\n\n[Update or delete a photo for a shared contact](/workspace/admin/domain-shared-contacts/update-delete-photo-shared-contacts)"]]