Crear una ubicación

Crea una nueva ubicación de negocio. Si la operación se completa correctamente, la ubicación se pone en cola para su envío a todas las plataformas de publicación de su plan (o, si se proporciona enabledSiteIds, solo a esos sitios). Campos obligatorios: name, un description de al menos 200 caracteres, subCategoryId, countryIso y, en los países cuyo sistema de direcciones requiere una ciudad, city. Una ubicación también necesita una dirección postal y un teléfono válidos para poder publicarse; proporciónalos al crearla para evitar una actualización posterior.

El id devuelto está codificado en base64 (e.g. TG9jYXRpb246MTgwMDI5MA==); decodifícalo para obtener la forma interna Location:<databaseId>. Todas las llamadas posteriores hacen referencia a este id en base64.

Caso de uso: dar de alta un único establecimiento con horario. Envía la dirección, phone, subCategoryId y un array businessHours, con una entrada por cada día de la semana que incluya franjas type: "OPEN" y { start, end }, o type: "CLOSED" con un array slots vacío para los días de cierre. Guarda tu propia clave en storeId para poder localizar la ubicación más adelante mediante obtener por códigos de tienda sin tener que guardar el ID de Listings API.

Los horarios especiales requieren un horario habitual. Los horarios especiales (excepciones por festivos o eventos, enviados como entradas businessHours con day: "SPECIAL", type: "OPEN" o "CLOSED", y un specialDate en formato YYYY-MM-DD) solo se publican cuando la ubicación también incluye su horario habitual de MONDAY a SUNDAY; Google rechaza una ubicación enviada con horarios especiales pero sin horario habitual. Incluye siempre los siete días de la semana en businessHours cuando establezcas entradas SPECIAL; consulta las reglas de horarios del endpoint de actualización para conocer el modelo completo.

Caso de uso: publicar en un subconjunto de sitios. Pasa enabledSiteIds (los ID de sitios del endpoint plan-sites) para publicar la ubicación en un subconjunto seleccionado de directorios en lugar de en todos los del plan; este es el patrón que utilizan las agencias para vender cobertura de sitios por niveles.

Configura los botones de acción de Google al crear la ubicación. Pasa placeActionLinks para configurar los botones de acción de Google de la ubicación (reservar una cita, hacer un pedido en línea, etc.) en la misma llamada. Los valores válidos de placeActionType son APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT y SHOP_ONLINE, con un máximo de un enlace preferido por tipo. Inmediatamente después de la creación, name y submissionStatus de cada enlace tienen el valor null hasta que el enlace se sincroniza con Google. Para añadir, editar o eliminar enlaces más adelante, utiliza actualizar una ubicación; consulta la guía de Place Action Links para conocer el modelo completo.

Errores comunes (devueltos como 400 con detalles en errors[]): description debe tener al menos 200 caracteres (SY10005), countryIso debe ser un país admitido (SY10036), city es obligatorio en los países cuyo sistema de direcciones requiere una ciudad (SY10126), state debe ser un código ISO válido, el código postal y el teléfono deben ser válidos para el país, subCategoryId debe existir y storeId debe ser único en toda la cuenta. Todas las solicitudes consumen lo mismo de tu límite de solicitudes independientemente del endpoint, por lo que dar de alta un gran volumen de ubicaciones provoca un 429 solo por el número de solicitudes; respeta la cabecera Retry-After y crea las ubicaciones de forma secuencial en lugar de hacerlo en una ráfaga.