Method: contactGroups.create

Erstellen Sie eine neue Kontaktgruppe, deren Inhaber der authentifizierte Nutzer ist.

Die erstellten Kontaktgruppennamen müssen für die Kontaktgruppen des Nutzers eindeutig sein. Wenn Sie versuchen, eine Gruppe mit einem doppelten Namen zu erstellen, wird der HTTP-Fehler 409 zurückgegeben.

Änderungsanfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.

HTTP-Anfrage

POST https://people.googleapis.com/v1/contactGroups

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Felder
contactGroup

object (ContactGroup)

Erforderlich. Die zu erstellende Kontaktgruppe
readGroupFields

string (FieldMask format)

Optional. Eine Feldmaske, mit der eingeschränkt wird, welche Felder in der Gruppe zurückgegeben werden. Wenn die Richtlinie nicht konfiguriert oder auf „leer“ gesetzt ist, werden standardmäßig metadata, groupType und name verwendet. Gültige Felder sind:

  • clientData
  • groupType
  • Metadaten
  • name

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von ContactGroup.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.