- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Aggiorna il nome di un gruppo di contatti esistente di proprietà dell'utente autenticato.
I nomi dei gruppi di contatti aggiornati devono essere univoci per i gruppi di contatti degli utenti. Se si tenta di creare un gruppo con un nome duplicato, verrà restituito un errore HTTP 409.
Le richieste modificate per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.
Richiesta HTTP
PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
contactGroup.resourceName |
Il nome della risorsa per il gruppo di contatti, assegnato dal server. Una stringa ASCII nel formato |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"contactGroup": {
"resourceName": string,
"etag": string,
"metadata": {
"updateTime": string,
"deleted": boolean
},
"groupType": enum ( |
Campi | |
---|---|
contactGroup.etag |
Il tag entità HTTP della risorsa. Utilizzato per la convalida della cache web. |
contactGroup.metadata |
Solo output. Metadati sul gruppo di contatti. |
contactGroup.groupType |
Solo output. Il tipo di gruppo di contatti. |
contactGroup.name |
Il nome del gruppo di contatti impostato dal proprietario del gruppo o un nome fornito dal sistema per i gruppi di sistema. Per |
contactGroup.formattedName |
Solo output. Il nome tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali dell'intestazione HTTP |
contactGroup.memberResourceNames[] |
Solo output. L'elenco dei nomi delle risorse delle persone di contatto che fanno parte del gruppo di contatti. Il campo viene compilato solo per le richieste GET e restituirà solo un numero di membri pari a |
contactGroup.memberCount |
Solo output. Il numero totale di contatti nel gruppo indipendentemente dal numero massimo di membri specificati nella richiesta. |
contactGroup.clientData[] |
I dati dei clienti del gruppo. |
updateGroupFields |
Campo facoltativo. Una maschera dei campi per limitare i campi del gruppo aggiornati. È possibile specificare più campi separandoli con virgole. Se non viene configurato o se viene lasciato vuoto, il valore predefinito è
|
readGroupFields |
Campo facoltativo. Una maschera dei campi per limitare i campi del gruppo che vengono restituiti. Se non viene configurato o se viene lasciato vuoto, il valore predefinito è
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di ContactGroup
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/contacts
Per ulteriori informazioni, consulta la guida all'autorizzazione.