v1Ressources/Locations/getRechercher dans la taxonomie de catégories générales

Rechercher dans la taxonomie de catégories générales

Recherche dans la taxonomie générale des catégories d'entreprise (reflète celle de Google, des milliers d'entrées) — données de référence globales, non limitées à votre agence. L'id renvoyé est un id de Category à définir comme categoryId d'un emplacement à la création ou la mise à jour. Pour le catalogue propre d'un publisher spécifique, utilisez plutôt GET /api/v1/locations/publisher-categories. Omettez complètement search pour lister toute la taxonomie, sans limite.

get/api/v1/locations/categories

locations:read

Paramètres de requête

searchstringfacultatif

Sous-chaîne du nom de catégorie à faire correspondre. Omettre pour lister toute la taxonomie, sans limite (limit est alors ignoré).

limitintegerfacultatif

Nombre de lignes à renvoyer, 1–100. La valeur par défaut est 25.

Réponse

dataobjectfacultatif

categoriesarray of objectfacultatif

Les catégories générales correspondantes.

idstringfacultatif

L'id de catégorie — transmettez-le en tant que categoryId lors de la création ou de la mise à jour.

namestringfacultatif

Le nom d'affichage de la catégorie.

Erreurs

401Clé API manquante, invalide, expirée ou révoquée.

403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.

429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.

get/api/v1/locations/categories

Votre clé API

search

limit

{
  "data": {
    "categories": [
      {
        "id": "cat_dentist",
        "name": "Dentist"
      },
      {
        "id": "cat_orthodontist",
        "name": "Orthodontist"
      }
    ]
  }
}