Method: contactGroups.members.modify

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

contactGroups/myContacts et contactGroups/starred sont les seuls groupes de contacts du système auxquels des membres peuvent être ajoutés. Les groupes de contacts des autres systèmes sont obsolètes et ne peuvent être supprimés que par 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 de ressources des contacts à ajouter sous la forme 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 de ressources des contacts à supprimer, sous la forme 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 contact.

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 de contacts introuvables.
canNotRemoveLastContactGroupResourceNames[]

string

Les noms des ressources de contacts 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.