v1Ressources/Locations/getRechercher dans le catalogue de catégories propre à un publisher

Rechercher dans le catalogue de catégories propre à un publisher

Recherche dans le catalogue propre (GABF) d'un publisher — données de référence globales, non limitées à votre agence. Utilisez l'id renvoyé pour les publisherCategories d'un emplacement à la création ou la mise à jour. Omettez complètement query pour lister tout le catalogue du publisher, sans limite.

get/api/v1/locations/publisher-categories

locations:read

Paramètres de requête

publisherstring (google | facebook | apple | bing)obligatoire

Le catalogue de quel publisher rechercher : google, apple, bing ou facebook.

querystringfacultatif

Sous-chaîne du nom de catégorie à faire correspondre. Omettre pour lister tout le catalogue du publisher, sans limite.

countrystringfacultatif

Pays au format ISO-3166-1 alpha-2 — recommandé pour apple, dont les catégories sont spécifiques à chaque pays.

Réponse

dataobjectfacultatif

categoriesarray of objectfacultatif

Les catégories correspondantes dans le catalogue propre au publisher demandé.

idstringfacultatif

L'id de catégorie propre au publisher — transmettez-le dans publisherCategories lors de la création ou de la mise à jour. Null est possible pour une entrée de catalogue sans id.

displayNamestringfacultatif

Le nom d'affichage de la catégorie dans le catalogue de ce publisher.

Erreurs

400Il manque un paramètre requis à la requête, ou elle est invalide.

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/publisher-categories

Votre clé API

publisher *

query

country

{
  "data": {
    "categories": [
      {
        "id": "gcid:dentist",
        "displayName": "Dentist"
      }
    ]
  }
}