Method: contactGroups.members.modify

Mitglieder einer Kontaktgruppe ändern, die dem authentifizierten Nutzer gehört.

Die einzigen Systemkontaktgruppen, denen Mitglieder hinzugefügt werden können, sind contactGroups/myContacts und contactGroups/starred. Andere Systemkontaktgruppen sind veraltet und 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 Kontaktgruppe, die geändert werden soll.

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 darf 1.000 nicht überschreiten.
resourceNamesToRemove[]

string

Optional. Die Ressourcennamen der zu entfernenden Kontakte im Format people/{person_id}. Die Gesamtzahl der Ressourcennamen in resourceNamesToAdd und resourceNamesToRemove darf 1.000 nicht überschreiten.

Antworttext

Die Antwort auf eine Anfrage zum Ändern der Kontaktgruppenmitglieder.

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

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

string

Die Ressourcennamen der Kontakte, die nicht gefunden wurden.
canNotRemoveLastContactGroupResourceNames[]

string

Die Ressourcennamen der Kontakte, die nicht aus ihrer 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.