Synupv1
Crear clave
v1Recursos/Locations/postSubir fotos a una ubicación

Subir fotos a una ubicación

Añade una o más fotos a una ubicación, en una categoría dada. Proporcione cada imagen como una URL https pública (que se obtiene y se vuelve a alojar) o como bytes en base64. Solo se admiten imágenes (jpeg, png, gif, webp), de hasta 5 MB cada una. La categoría LOGO contiene un único logo — subir una a LOGO reemplaza la actual. Cualquier otra categoría añade a la lista existente. Las fotos guardadas se ponen en cola automáticamente para publicarse en Google.

post/api/v1/locations/{id}/media
locations:write
Parámetros de consulta
idstringobligatorio
La ubicación a la que añadir fotos.
Cuerpo de la solicitud
categorystring (COVER | PROFILE | LOGO | EXTERIOR | INTERIOR | PRODUCT | FOOD_AND_DRINK | MENU | AT_WORK | TEAMS | ROOMS | COMMON_AREA | ADDITIONAL)obligatorio
La categoría de foto a la que añadir. LOGO reemplaza el logo actual; cualquier otra categoría añade a la lista.
imagesarray of objectobligatorio
Una o más imágenes a añadir. Cada una necesita una url o base64.
urlstringopcional
Una URL https pública de la imagen — se obtiene y se vuelve a alojar.
base64stringopcional
Los bytes de la imagen en base64 (se acepta un prefijo de URL data:). Úselo en lugar de url cuando disponga de los bytes.
labelstringopcional
Leyenda o etiqueta opcional para la foto.
Respuesta
dataobjectopcional
mediaByCategoryobjectopcional
Elementos multimedia agrupados por categoría (p. ej. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Cada elemento tiene una url y, opcionalmente, un label, un kind (PHOTO o VIDEO), una source, un indicador starred y un assetKey.
addedarray of objectopcional
Las fotos que se añadieron realmente, cada una con la categoría en la que quedó y su URL alojada.
categorystringopcional
urlstringopcional
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/locations/{id}/media
Su clave de API
id *
Cuerpo de la solicitud*
{
  "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"
      }
    ]
  }
}