Method: contactGroups.create

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

Die Namen der erstellten Kontaktgruppen müssen für die Kontaktgruppen der Nutzer eindeutig sein. Beim Versuch, eine Gruppe mit einem doppelten Namen zu erstellen, wird der HTTP-Fehler 409 zurückgegeben.

Mutate-Anfragen 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 zur Einschränkung der zurückgegebenen Felder in der Gruppe. Wenn kein Wert festgelegt oder das Feld leer ist, wird der Standardwert metadata, groupType und name verwendet. Gültige Felder sind:

  • Kundendaten
  • Gruppentyp
  • metadata
  • 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 Autorisierungsleitfaden.