Synupv1
Créer une clé
v1Ressources/Locations/postTéléverser des photos vers un établissement

Téléverser des photos vers un établissement

Ajoute une ou plusieurs photos à un établissement, dans une catégorie donnée. Fournissez chaque image sous forme d'URL https publique (récupérée et réhébergée) ou d'octets encodés en base64. Seules les images sont prises en charge (jpeg, png, gif, webp), 5 Mo maximum chacune. La catégorie LOGO ne contient qu'un seul logo — téléverser vers LOGO remplace celui en cours. Toute autre catégorie s'ajoute à l'existant. Les photos enregistrées sont automatiquement mises en file d'attente pour être publiées sur Google.

post/api/v1/locations/{id}/media
locations:write
Paramètres de requête
idstringobligatoire
L'établissement auquel ajouter des photos.
Corps de la requête
categorystring (COVER | PROFILE | LOGO | EXTERIOR | INTERIOR | PRODUCT | FOOD_AND_DRINK | MENU | AT_WORK | TEAMS | ROOMS | COMMON_AREA | ADDITIONAL)obligatoire
La catégorie de photo à laquelle ajouter. LOGO remplace le logo actuel ; toute autre catégorie s'ajoute à l'existant.
imagesarray of objectobligatoire
Une ou plusieurs images à ajouter. Chacune nécessite un url ou un base64.
urlstringfacultatif
Une URL https publique vers l'image — elle est récupérée et réhébergée.
base64stringfacultatif
Les octets de l'image en base64 (un préfixe d'URL data: est accepté). Utilisez ceci à la place de url lorsque vous disposez des octets.
labelstringfacultatif
Légende/libellé optionnel pour la photo.
Réponse
dataobjectfacultatif
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.
addedarray of objectfacultatif
La ou les photos réellement ajoutées, chacune avec la catégorie dans laquelle elle a été placée et son URL hébergée.
categorystringfacultatif
urlstringfacultatif
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.
404La ressource est introuvable, ou n'appartient pas à votre agence.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/locations/{id}/media
Votre clé API
id *
Corps de la requête*
{
  "data": {
    "mediaByCategory": {
      "EXTERIOR": [
        {
          "url": "https://cdn.synup.com/media/1.jpg",
          "source": "agent_upload"
        }
      ]
    },
    "added": [
      {
        "category": "EXTERIOR",
        "url": "https://cdn.synup.com/media/1.jpg"
      }
    ]
  }
}