Method: otherContacts.search

Fournit une liste de contacts parmi les autres contacts de l'utilisateur authentifié qui correspond à la requête de recherche. La requête correspond aux champs names, emailAddresses et phoneNumbers d'un contact provenant de la source OTHER_CONTACT.

IMPORTANT: Avant la recherche, les clients doivent envoyer une requête de préchauffage contenant une requête vide pour mettre à jour le cache. Voir https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts

Requête HTTP

GET https://people.googleapis.com/v1/otherContacts:search

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
query

string

Obligatoire. Requête en texte brut de la requête. La requête permet de faire correspondre des expressions de préfixe des champs d'une personne. Par exemple, une personne portant le nom "foo name" correspond aux requêtes telles que "f", "fo", "foo", "foo n", "nam", etc., mais pas "oo n".

pageSize

integer

Facultatif. Nombre de résultats à renvoyer. La valeur par défaut est 10 si le champ n'est pas défini, ou la valeur 0. Les valeurs supérieures à 30 seront limitées à 30.

readMask

string (FieldMask format)

Obligatoire. Masque de champ permettant de limiter les champs renvoyés pour chaque personne. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Les valeurs possibles sont les suivantes :

  • emailAddresses
  • métadonnées
  • names
  • phoneNumbers

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de SearchResponse.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

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