Method: contactGroups.members.modify

Modifica 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 deprecati e possono essere rimossi solo 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

(Facoltativo) I nomi delle risorse delle persone di contatto 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

(Facoltativo) I nomi delle risorse delle persone di contatto 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 del gruppo di contatti.

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 non trovati.

canNotRemoveLastContactGroupResourceNames[]

string

I nomi delle risorse di contatto 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.