Method: contactGroups.members.modify

Modifica los miembros de un grupo de contactos que pertenece al usuario autenticado.

Los únicos grupos de contactos del sistema a los que se pueden agregar miembros son contactGroups/myContacts y contactGroups/starred. Los demás grupos de contactos del sistema dejaron de estar disponibles 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 recursos de las personas de contacto que se deben quitar, en 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 de modificación de los miembros del 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 personas de contacto que no se encontraron.
canNotRemoveLastContactGroupResourceNames[]

string

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

Alcances 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.