Method: contactGroups.members.modify

Modifier les membres d'un groupe de contacts appartenant à l'utilisateur authentifié.

Les seuls groupes de contacts système pouvant avoir des membres sont contactGroups/myContacts et contactGroups/starred. D'autres groupes de contacts système sont obsolètes et ne peuvent supprimer que des contacts.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
resourceName

string

Obligatoire. Nom de ressource du groupe de contacts à modifier.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
Champs
resourceNamesToAdd[]

string

Facultatif. Noms des ressources des contacts à ajouter au format people/{person_id}. Le nombre total de noms de ressources dans resourceNamesToAdd et resourceNamesToRemove doit être inférieur ou égal à 1 000.
resourceNamesToRemove[]

string

Facultatif. Noms des ressources des contacts à supprimer au format people/{person_id}. Le nombre total de noms de ressources dans resourceNamesToAdd et resourceNamesToRemove doit être inférieur ou égal à 1 000.

Corps de la réponse

Réponse à une demande de modification des membres d'un groupe de contacts.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
Champs
notFoundResourceNames[]

string

Noms des ressources des contacts introuvables.
canNotRemoveLastContactGroupResourceNames[]

string

Noms des ressources de contacts qui ne peuvent pas être supprimés de leur dernier groupe de contacts.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le Guide relatif aux autorisations.