Method: contactGroups.members.modify

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

Die einzigen Systemkontaktgruppen, denen Mitglieder hinzugefügt werden können, sind contactGroups/myContacts und contactGroups/starred. Andere Systemkontaktgruppen sind veraltet und es können nur 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 Personen 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 Kontakte im Format people/{person_id}. Die Gesamtzahl der Ressourcennamen in resourceNamesToAdd und resourceNamesToRemove muss kleiner oder gleich 1.000 sein.

Antworttext

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

Die Antwort auf eine Anfrage zum Ändern von Mitgliedern der Kontaktgruppe.

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

string

Die Ressourcennamen der kontaktierten Personen, 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 Autorisierungsleitfaden.