Synupv1
Créer une clé
v1Ressources/Locations/getLister les établissements avec leurs médias

Lister les établissements avec leurs médias

Liste les établissements avec leurs photos, les plus récents en premier — mêmes filtres que GET /api/v1/locations. Utilisez ceci pour des questions comme « quels établissements n'ont pas de photos ? », plutôt que GET /api/v1/media, qui ne renvoie les médias que d'UN seul établissement à la fois.

get/api/v1/locations/media
media:read
Paramètres de requête
clientIdstringfacultatif
Limite aux établissements d'un seul client. Obligatoire lorsque votre clé est limitée à des clients spécifiques — il n'y a ici aucun champ client par ligne permettant de vérifier un résultat fusionné et non limité, donc un clientId omis est refusé plutôt que deviné. Retrouvez-le avec GET /api/v1/clients.
searchstringfacultatif
Recherche libre sur le nom, l'adresse postale, la ville ou le téléphone de l'établissement (insensible à la casse, correspondances partielles autorisées).
statusstring (all | active | archived | archival_pending | verification_pending | unapproved | requires_action)facultatif
Une seule catégorie de statut : all, active (non archivé), archived, archival_pending, verification_pending (approbation Google en attente), unapproved ou requires_action. La valeur par défaut est all.
tagsarray of stringfacultatif
Étiquettes internes — correspond à un établissement possédant au moins une d'entre elles.
categoriesarray of stringfacultatif
Noms d'affichage de catégories — correspond à un établissement dont la catégorie générale ou Google est l'une d'elles.
verificationarray of string (verified | pending | unverified | unknown)facultatif
État de vérification Google : verified, pending, unverified ou unknown.
createdAfterstringfacultatif
Uniquement les établissements créés à cette date ou après.
createdBeforestringfacultatif
Uniquement les établissements créés à cette date ou avant.
cursorstringfacultatif
Curseur de pagination provenant du nextCursor d'une réponse précédente. Laisser vide pour la première page.
limitintegerfacultatif
Nombre d'établissements à renvoyer par page, 1–100. La valeur par défaut est 100.
Réponse
dataobjectfacultatif
locationsarray of objectfacultatif
Les établissements correspondants pour cette page.
idstringfacultatif
Identifiant unique de l'établissement.
namestringfacultatif
Le nom commercial de l'établissement.
logoUrlstringfacultatif
URL du logo de l'établissement, ou null.
mediaByCategoryobjectfacultatif
Éléments multimédias regroupés par catégorie (par ex. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Chaque élément possède une url et, éventuellement, un label, un kind (PHOTO ou VIDEO), une source, un indicateur starred et un assetKey.
totalnumberfacultatif
Nombre total de photos dans toutes les catégories pour cet établissement.
nextCursorstringfacultatif
Curseur de pagination pour la page suivante, ou null lorsqu'il n'y a plus de résultats.
totalnumberfacultatif
Nombre total d'établissements correspondant aux filtres, sur toutes les pages.
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/media
Votre clé API
clientId
search
status
tags
categories
verification
createdAfter
createdBefore
cursor
limit
{
  "data": {
    "locations": [
      {
        "id": "loc_456",
        "name": "Acme Dental — Downtown",
        "logoUrl": null,
        "mediaByCategory": {
          "EXTERIOR": [
            {
              "url": "https://cdn.synup.com/media/1.jpg"
            }
          ]
        },
        "total": 1
      }
    ],
    "nextCursor": null,
    "total": 1
  }
}