Synupv1
Criar chave
v1Recursos/Locations/postEnviar fotos para um local

Enviar fotos para um local

Adiciona uma ou mais fotos a um local, em uma determinada categoria. Informe cada imagem como uma URL https pública (buscada e re-hospedada) ou como bytes base64. Apenas imagens são suportadas (jpeg, png, gif, webp), com máximo de 5 MB cada. A categoria LOGO guarda um único logotipo — enviar para LOGO substitui o atual. Toda outra categoria apenas acrescenta. As fotos salvas são automaticamente colocadas na fila para publicação no Google.

post/api/v1/locations/{id}/media
locations:write
Parâmetros de consulta
idstringobrigatório
O local ao qual adicionar fotos.
Corpo da solicitação
categorystring (COVER | PROFILE | LOGO | EXTERIOR | INTERIOR | PRODUCT | FOOD_AND_DRINK | MENU | AT_WORK | TEAMS | ROOMS | COMMON_AREA | ADDITIONAL)obrigatório
A categoria de foto à qual adicionar. LOGO substitui o logotipo atual; toda outra categoria apenas acrescenta.
imagesarray of objectobrigatório
Uma ou mais imagens a adicionar. Cada uma precisa de um url ou base64.
urlstringopcional
Uma URL https pública para a imagem — ela é buscada e re-hospedada.
base64stringopcional
Os bytes da imagem em base64 (um prefixo de URL data: é aceito). Use isso em vez de url quando você tiver os bytes.
labelstringopcional
Legenda/rótulo opcional para a foto.
Resposta
dataobjectopcional
mediaByCategoryobjectopcional
Itens de mídia agrupados por categoria (ex.: EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Cada item tem uma url e, opcionalmente, um label, um kind (PHOTO ou VIDEO), uma source, um indicador starred e um assetKey.
addedarray of objectopcional
A(s) foto(s) que foram realmente adicionadas, cada uma com a categoria em que ficou e sua URL hospedada.
categorystringopcional
urlstringopcional
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/locations/{id}/media
Sua chave de API
id *
Corpo da solicitação*
{
  "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"
      }
    ]
  }
}