Method: contactGroups.members.modify

Modificare i membri di un gruppo di contatti di proprietà dell'utente autenticato.

Gli unici gruppi di contatti di sistema a cui è possibile aggiungere membri sono contactGroups/myContacts e contactGroups/starred. Gli altri gruppi di contatti di sistema sono stati ritirati e possono essere rimossi solo i contatti.

Richiesta HTTP

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resourceName

string

obbligatorio. Il nome della risorsa del gruppo di contatti da modificare.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
Campi
resourceNamesToAdd[]

string

Campo facoltativo. I nomi delle risorse dei contatti da aggiungere nel formato people/{person_id}. Il numero totale di nomi di risorse in resourceNamesToAdd e resourceNamesToRemove deve essere minore o uguale a 1000.
resourceNamesToRemove[]

string

Campo facoltativo. I nomi delle risorse dei contatti da rimuovere nel formato people/{person_id}. Il numero totale di nomi di risorse in resourceNamesToAdd e resourceNamesToRemove deve essere minore o uguale a 1000.

Corpo della risposta

La risposta a una richiesta di modifica dei membri di un gruppo di contatto.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
Campi
notFoundResourceNames[]

string

I nomi delle risorse di contatto delle persone che non sono stati trovati.
canNotRemoveLastContactGroupResourceNames[]

string

I nomi delle risorse dei contatti che non possono essere rimossi dall'ultimo gruppo di contatti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la guida all'autorizzazione.