Method: contactGroups.members.modify

Modificar los miembros de un grupo de contactos que pertenecen al usuario autenticado.

Los únicos grupos de contactos del sistema que pueden tener miembros agregados son contactGroups/myContacts y contactGroups/starred. Otros grupos de contactos del sistema están obsoletos y solo se pueden quitar contactos.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
resourceName

string

Obligatorio. El nombre del recurso del grupo de contactos que se modificará.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
Campos
resourceNamesToAdd[]

string

Opcional. Los nombres de recurso de las personas de contacto que se agregarán con el formato people/{person_id}. La cantidad total de nombres de recursos en resourceNamesToAdd y resourceNamesToRemove debe ser menor o igual que 1,000.
resourceNamesToRemove[]

string

Opcional. Los nombres de recurso de las personas de contacto que se quitarán con el formato people/{person_id}. La cantidad total de nombres de recursos en resourceNamesToAdd y resourceNamesToRemove debe ser menor o igual que 1,000.

Cuerpo de la respuesta

La respuesta a una solicitud para modificar los miembros de un grupo de contactos.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
Campos
notFoundResourceNames[]

string

Los nombres de los recursos de las personas de contacto que no se encontraron.
canNotRemoveLastContactGroupResourceNames[]

string

Los nombres de los recursos de personas de contacto que no se pueden quitar de su último grupo de contactos.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la guía de autorización.