Synupv1
Crear clave
v1Recursos/Locations/patchActualizar una ubicación

Actualizar una ubicación

Edita los datos de negocio de una ubicación existente — dirección, categorías, atributos del perfil de Google Business, servicios y horario. Envíe solo los campos que desea cambiar; un campo que sí envíe reemplaza su valor actual por completo (una cadena vacía borra un campo de texto, una lista nueva completa reemplaza una existente). El país no puede cambiarse después de la creación. Los cambios guardados se ponen en cola automáticamente para sincronizarse con los directorios y listados conectados.

patch/api/v1/locations/{id}
locations:write
Parámetros de consulta
idstringobligatorio
La ubicación a actualizar.
Cuerpo de la solicitud
namestringopcional
El nombre comercial de la ubicación.
descriptionstringopcional
Una breve descripción del negocio.
taglinestringopcional
Un lema o eslogan breve del negocio.
storeCodestringopcional
Su código o referencia interna de tienda para esta ubicación.
logoUrlstringopcional
URL de la imagen del logo de la ubicación.
languageCodestringopcional
El idioma principal del listado, como código (p. ej. "en").
streetstringopcional
Dirección postal.
street1stringopcional
Dirección postal, línea 2.
citystringopcional
Ciudad.
stateIsostringopcional
Estado o región, como código ISO (p. ej. "CA").
postalCodestringopcional
Código postal.
latitudenumberopcional
Latitud. Si cambia la dirección sin establecer también esto, se vuelve a derivar automáticamente.
longitudenumberopcional
Longitud. Si cambia la dirección sin establecer también esto, se vuelve a derivar automáticamente.
phonestringopcional
Número de teléfono.
additionalPhonesarray of stringopcional
Cualquier número de teléfono adicional además del principal.
websitestringopcional
URL del sitio web.
businessEmailstringopcional
Un correo electrónico de contacto público del negocio.
categoryIdstringopcional
Id de categoría general — búsquelo con GET /api/v1/locations/categories.
categoryNamestringopcional
Nombre visible de la categoría general.
publisherCategoriesobjectopcional
Categoría PRINCIPAL por publisher — actualmente solo se admite google aquí (se requieren tanto un id como un name; enviar solo uno de ellos borraría la categoría). Facebook/Apple/Bing solo pueden cambiarse en el editor de ubicaciones. Busque el par id/name de google con GET /api/v1/locations/publisher-categories.
googleobjectopcional
idstringopcional
namestringopcional
additionalCategoriesarray of objectopcional
Hasta 9 categorías adicionales, cada una un { id?, name }. Se acepta un name solo, y su id se resuelve a partir del catálogo de categorías cuando hay una coincidencia. Busque los ids usted mismo con GET /api/v1/locations/categories.
idstringopcional
namestringopcional
attributesobjectopcional
Atributos del perfil de Google Business, como un mapa de id de atributo a valor (p. ej. { "attributes/wi_fi": "free" }) — REEMPLAZA el conjunto completo, así que lea los actuales desde GET /api/v1/locations/{id} y vuelva a enviar todo lo que desee conservar. Un id sin una representación válida en Google para la categoría de esta ubicación se descarta y se informa en rejectedAttributes en lugar de hacer fallar toda la solicitud. No hay un endpoint que liste qué ids de atributo son válidos para una categoría — eso es la propia referencia de atributos de Business Profile de Google, no de Synup.
servicesarray of objectopcional
Los servicios o productos que ofrece esta ubicación — reemplaza la lista existente.
namestringopcional
descriptionstringopcional
pricenumberopcional
currencystringopcional
googleServiceTypeIdstringopcional
ownerNamestringopcional
El nombre del propietario.
menuUrlstringopcional
URL del menú del negocio.
yearEstablishednumberopcional
El año en que se estableció el negocio (p. ej. 2012).
tagsarray of stringopcional
Etiquetas internas para su propia organización — no se muestran públicamente. Reemplaza la lista existente.
labelsarray of stringopcional
Rótulos internos para esta ubicación. Reemplaza la lista existente.
regularHoursarray of objectopcional
El horario semanal habitual — reemplaza por completo el horario existente. Una entrada por día de la semana.
daystring (MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY)opcional
closedbooleanopcional
periodsarray of objectopcional
openstringopcional
closestringopcional
moreHoursarray of objectopcional
Tipos de horario adicionales más allá del horario habitual (entrega, para llevar, happy hour, etc.), reemplaza la lista existente.
specialHoursarray of objectopcional
Anulaciones puntuales de fecha — cierres por festivo o el horario especial de un solo día — reemplaza la lista existente. Funciona con cualquier fecha del calendario, no solo festivos con nombre.
applyToPublishersarray of string (google | facebook | apple | bing)opcional
Cambia estos valores solo para publishers específicos en lugar del valor predeterminado compartido que hereda cada publisher.
Respuesta
dataobjectopcional
locationobjectopcional
El perfil de negocio completo de una ubicación: dirección, horario, categorías, atributos, servicios, medios y estado — todo lo que update_location puede cambiar, además de lo que create devolvió.
idstringopcional
Identificador único de la ubicación.
namestringopcional
El nombre comercial de la ubicación.
descriptionstringopcional
Una descripción del negocio, o null.
taglinestringopcional
Un lema o eslogan breve del negocio, o null.
storeCodestringopcional
Su código o referencia interna de tienda para esta ubicación, o null.
logoUrlstringopcional
URL de la imagen del logo de la ubicación, o null.
streetstringopcional
Dirección postal, línea 1, o null.
street1stringopcional
Dirección postal, línea 2, o null.
citystringopcional
Ciudad.
statestringopcional
Estado o región.
postalCodestringopcional
Código postal, o null.
countrystringopcional
País, como código ISO-3166-1 alfa-2, o null.
latitudenumberopcional
Latitud, o null.
longitudenumberopcional
Longitud, o null.
phonestringopcional
Número de teléfono principal, o null.
additionalPhonesarray of stringopcional
Cualquier número de teléfono adicional además del principal.
websitestringopcional
La URL del sitio web de la ubicación, o null.
businessEmailstringopcional
Un correo electrónico de contacto público del negocio, o null.
categoryNamestringopcional
El nombre visible de la categoría general, o null.
primaryCategoryDisplaystringopcional
El nombre visible de la categoría principal efectiva — por publisher (Google) si está establecida, si no, la general — o null.
primaryCategoryGooglestringopcional
El id de la categoría principal de Google de la ubicación (gcid), o null.
additionalCategoriesarray of objectopcional
Hasta 9 categorías adicionales, cada una con un id (cuando se resuelve) y un nombre visible.
idstringopcional
namestringopcional
attributesarray of objectopcional
Atributos del perfil de Google Business, como la lista almacenada { id, value }.
idstringopcional
valueobjectopcional
El valor del atributo — un booleano para atributos de sí/no, una cadena para los de elección única, o un objeto con setValues/unsetValues para los de selección múltiple.
servicesarray of objectopcional
Los servicios o productos que ofrece esta ubicación.
namestringopcional
descriptionstringopcional
pricenumberopcional
currencystringopcional
googleServiceTypeIdstringopcional
ownerNamestringopcional
El nombre del propietario, o null.
menuUrlstringopcional
URL del menú del negocio, o null.
yearEstablishednumberopcional
El año en que se estableció el negocio, o null.
tagsarray of stringopcional
Etiquetas internas para su propia organización — no se muestran públicamente.
labelsarray of stringopcional
Rótulos internos para esta ubicación.
regularHoursarray of objectopcional
El horario semanal habitual, o null.
daystring (MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY)opcional
closedbooleanopcional
periodsarray of objectopcional
moreHoursarray of objectopcional
Tipos de horario adicionales más allá del horario habitual (entrega, para llevar, etc.), o null.
specialHoursarray of objectopcional
Anulaciones puntuales de fecha — cierres por festivo o el horario especial de un solo día — o null.
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.
clientIdstringopcional
ID del cliente al que pertenece esta ubicación, o null.
archivedbooleanopcional
Si la ubicación está archivada.
scheduledArchiveAtstringopcional
Fecha en que se solicitó el archivado (también el token que usa cancel-archive para identificarlo), como marca de tiempo ISO 8601, o null si no hay ninguno pendiente.
verificationStatusstring (verified | pending | unverified | unknown)opcional
Estado de verificación de Google: verified, pending, unverified o unknown, o null.
rejectedAttributesarray of stringopcional
Ids de atributos de la solicitud que NO se escribieron — o bien tienen su propio campo dedicado, o su valor no tenía una representación válida en Google. Presente solo cuando se rechazó al menos uno.
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.
patch/api/v1/locations/{id}
Su clave de API
id *
Cuerpo de la solicitud
{
  "data": {
    "location": {
      "id": "loc_456",
      "name": "Acme Dental — Downtown",
      "tagline": "Gentle care, on time",
      "city": "Austin",
      "state": "TX",
      "clientId": "cli_123"
    },
    "rejectedAttributes": []
  }
}