Method: contactGroups.create

Erstellen Sie eine neue Kontaktgruppe, die dem authentifizierten Nutzer gehört.

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

Änderungsanfragen für denselben Nutzer sollten sequenziell 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, um einzuschränken, welche Felder für die Gruppe zurückgegeben werden. Wenn kein Wert festgelegt oder ein leerer Wert festgelegt wird, 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.