Crear una ubicación

ID del cliente bajo el que se crea esta ubicación. Búscalo con GET /api/v1/clients. Opcional, como «Sin cliente» en la aplicación: si lo omites, la ubicación se crea por sí sola. Una clave limitada a clientes concretos debe enviarlo.

location (the default) is a physical business listing. website is a website entity — a brand's site tracked for reviews, SEO, AEO and social — created from a name and a website alone. It is not a billable location, and it needs website entities enabled for the workspace (403 otherwise).

El nombre comercial de la ubicación.

Código de país ISO, p. ej. US.

Dirección postal.

Dirección postal, línea 2.

Ciudad.

Código de estado o región.

Código postal.

Número de teléfono.

Cualquier número de teléfono adicional además del principal.

URL del sitio web.

Id de la categoría general, de GET /api/v1/locations/categories. Una ubicación necesita una categoría: envía esto, categoryName o publisherCategories.google.

Nombre visible de la categoría general. Una ubicación necesita una categoría: envía esto, categoryId o publisherCategories.google. Un nombre que no coincide con el catálogo se guarda como categoría visible.

Categorías por publisher, una por publisher, cada una un { id, name } consultado con GET /api/v1/locations/publisher-categories. Al crear, publisherCategories.google también cumple el requisito de categoría.

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. Busca los ids tú mismo con GET /api/v1/locations/categories.

Una breve descripción del negocio.

Etiquetas internas para su propia organización — no se muestran públicamente.

Latitud, en grados decimales. Se deriva automáticamente de la dirección si se omite.

Longitud, en grados decimales. Se deriva automáticamente de la dirección si se omite.

Valores de campos personalizados a establecer en esta ubicación, indexados por id de campo.

Configuración del área de servicio en Master, para un negocio que atiende a los clientes en su ubicación. Define businessType como CUSTOMER_LOCATION_ONLY para ocultar la dirección: ningún publisher recibe una calle que fuera a mostrar, aunque haya una guardada. Envía null para quitarla. Para definirla solo en algunos publishers, usa publisherServiceAreas o applyToPublishers.

CUSTOMER_LOCATION_ONLY oculta la dirección (solo área de servicio). CUSTOMER_AND_BUSINESS_LOCATION muestra la dirección y las áreas atendidas.

Áreas atendidas, hasta 20. Cada una es { name, placeId?, placeType? }. Google y Bing las publican. Facebook y Apple no tienen una lista de áreas de servicio, así que para ellos solo se aplica la calle oculta.

ID de lugar de Google del área. Google solo acepta lugares que lo tengan, así que un lugar sin él se guarda pero no se envía a Google.

Un área de servicio distinta para Google, Facebook, Apple o Bing, cada una con la misma forma que serviceArea. Se guarda como el valor propio de ese publisher y se devuelve en publisherOverrides. Un publisher que omitas usa serviceArea.

Configuración del área de servicio en Master, para un negocio que atiende a los clientes en su ubicación. Define businessType como CUSTOMER_LOCATION_ONLY para ocultar la dirección: ningún publisher recibe una calle que fuera a mostrar, aunque haya una guardada. Envía null para quitarla. Para definirla solo en algunos publishers, usa publisherServiceAreas o applyToPublishers.

CUSTOMER_LOCATION_ONLY oculta la dirección (solo área de servicio). CUSTOMER_AND_BUSINESS_LOCATION muestra la dirección y las áreas atendidas.

Áreas atendidas, hasta 20. Cada una es { name, placeId?, placeType? }. Google y Bing las publican. Facebook y Apple no tienen una lista de áreas de servicio, así que para ellos solo se aplica la calle oculta.

ID de lugar de Google del área. Google solo acepta lugares que lo tengan, así que un lugar sin él se guarda pero no se envía a Google.

Configuración del área de servicio en Master, para un negocio que atiende a los clientes en su ubicación. Define businessType como CUSTOMER_LOCATION_ONLY para ocultar la dirección: ningún publisher recibe una calle que fuera a mostrar, aunque haya una guardada. Envía null para quitarla. Para definirla solo en algunos publishers, usa publisherServiceAreas o applyToPublishers.

CUSTOMER_LOCATION_ONLY oculta la dirección (solo área de servicio). CUSTOMER_AND_BUSINESS_LOCATION muestra la dirección y las áreas atendidas.

Áreas atendidas, hasta 20. Cada una es { name, placeId?, placeType? }. Google y Bing las publican. Facebook y Apple no tienen una lista de áreas de servicio, así que para ellos solo se aplica la calle oculta.

ID de lugar de Google del área. Google solo acepta lugares que lo tengan, así que un lugar sin él se guarda pero no se envía a Google.

Configuración del área de servicio en Master, para un negocio que atiende a los clientes en su ubicación. Define businessType como CUSTOMER_LOCATION_ONLY para ocultar la dirección: ningún publisher recibe una calle que fuera a mostrar, aunque haya una guardada. Envía null para quitarla. Para definirla solo en algunos publishers, usa publisherServiceAreas o applyToPublishers.

CUSTOMER_LOCATION_ONLY oculta la dirección (solo área de servicio). CUSTOMER_AND_BUSINESS_LOCATION muestra la dirección y las áreas atendidas.

Áreas atendidas, hasta 20. Cada una es { name, placeId?, placeType? }. Google y Bing las publican. Facebook y Apple no tienen una lista de áreas de servicio, así que para ellos solo se aplica la calle oculta.

ID de lugar de Google del área. Google solo acepta lugares que lo tengan, así que un lugar sin él se guarda pero no se envía a Google.

Configuración del área de servicio en Master, para un negocio que atiende a los clientes en su ubicación. Define businessType como CUSTOMER_LOCATION_ONLY para ocultar la dirección: ningún publisher recibe una calle que fuera a mostrar, aunque haya una guardada. Envía null para quitarla. Para definirla solo en algunos publishers, usa publisherServiceAreas o applyToPublishers.

CUSTOMER_LOCATION_ONLY oculta la dirección (solo área de servicio). CUSTOMER_AND_BUSINESS_LOCATION muestra la dirección y las áreas atendidas.

Áreas atendidas, hasta 20. Cada una es { name, placeId?, placeType? }. Google y Bing las publican. Facebook y Apple no tienen una lista de áreas de servicio, así que para ellos solo se aplica la calle oculta.

ID de lugar de Google del área. Google solo acepta lugares que lo tengan, así que un lugar sin él se guarda pero no se envía a Google.

URL de perfiles sociales: facebook, instagram, twitter, linkedin, youtube, tiktok, pinterest. Al actualizar solo cambian las claves que envías; null borra una. Se publican en Google como sus atributos url_* y en Bing y Apple.