Method: contactGroups.create

Crea un nuovo gruppo di contatti di proprietà dell'utente autenticato.

I nomi dei gruppi di contatti creati devono essere univoci per i gruppi di contatti degli utenti. Se provi a creare un gruppo con un nome duplicato, verrà restituito un errore HTTP 409.

Le richieste di modifica per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Campi
contactGroup

object (ContactGroup)

Obbligatorio. Il gruppo di contatti da creare.

readGroupFields

string (FieldMask format)

(Facoltativo) Una maschera del campo per limitare i campi restituiti del gruppo. Se il campo non viene configurato o se viene lasciato vuoto, il valore predefinito è metadata, groupType e name. I campi validi sono:

  • clientData
  • groupType
  • metadati
  • nome

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ContactGroup appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.