Method: contactGroups.members.modify

Modifica los miembros de un grupo de contactos perteneciente al usuario autenticado.

Los únicos grupos de contactos del sistema a los que se pueden agregar miembros son contactGroups/myContacts y contactGroups/starred. Otros grupos de contactos del sistema dejaron de estar disponibles y solo se pueden quitar los 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 recursos de las personas de contacto que se agregarán 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.

resourceNamesToRemove[]

string

Opcional. Los nombres de recursos de las personas de contacto que se quitarán en el formato de 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

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

Es la respuesta a una solicitud de modificación de miembros del grupo de contactos.

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

string

No se encontraron los nombres de los recursos de contactos.

canNotRemoveLastContactGroupResourceNames[]

string

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

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