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 ( |
Felder | |
---|---|
contactGroup |
Erforderlich. Die zu erstellende Kontaktgruppe |
readGroupFields |
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
|
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.