Method: contactGroups.members.modify

Mitglieder einer Kontaktgruppe ändern, deren Inhaber der authentifizierte Nutzer ist

Die einzigen Systemkontaktgruppen, denen Mitglieder hinzugefügt werden können, sind contactGroups/myContacts und contactGroups/starred. Andere Systemkontaktgruppen wurden eingestellt. Sie können nur noch Kontakte entfernt werden.

HTTP-Anfrage

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
resourceName

string

Erforderlich. Der Ressourcenname der zu ändernden Kontaktgruppe.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
Felder
resourceNamesToAdd[]

string

Optional. Die Ressourcennamen der hinzuzufügenden Kontaktpersonen im Format people/{person_id}. Die Gesamtzahl der Ressourcennamen in resourceNamesToAdd und resourceNamesToRemove muss kleiner oder gleich 1.000 sein.
resourceNamesToRemove[]

string

Optional. Die Ressourcennamen der zu entfernenden Kontaktpersonen im Format people/{person_id}. Die Gesamtzahl der Ressourcennamen in resourceNamesToAdd und resourceNamesToRemove muss kleiner oder gleich 1.000 sein.

Antworttext

Die Antwort auf die Anfrage zum Ändern von Kontaktgruppenmitgliedern.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
Felder
notFoundResourceNames[]

string

Die Ressourcennamen von Kontaktpersonen, die nicht gefunden wurden.
canNotRemoveLastContactGroupResourceNames[]

string

Die Ressourcennamen von Kontakten, die nicht aus der letzten Kontaktgruppe entfernt werden können.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/contacts

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.