Actualizar una ubicación

Actualiza una sola ubicación. Solo se modifican los campos presentes en input; todo lo que omitas conserva su valor actual. id es el único campo obligatorio.

Caso de uso: corregir un número de teléfono. Envía solo id y phone para corregir los datos de contacto sin modificar la dirección ni el horario. La respuesta devuelve la ubicación actualizada para que puedas confirmar que se han aplicado los nuevos valores.

Caso de uso: publicar un horario semanal completo. Envía el array businessHours de siete días (como en la solicitud de ejemplo) para establecer los intervalos de apertura de cada día. Marca los días de cierre con { "day": "SUNDAY", "type": "CLOSED", "slots": [] }.

Reglas del horario comercial.

• Incluye los siete días; se rechaza cualquier semana incompleta.
• Las horas usan start/end dentro de cada entrada de slots (e.g, 09:00am, 05:00pm); los intervalos de un mismo día no deben solaparse.
• Las excepciones por festivos y eventos son entradas adicionales con day: "SPECIAL" y un specialDate (YYYY-MM-DD), que se envían junto con las siete entradas de los días de la semana, nunca en su lugar.
• Usa SPECIAL solo en businessHours. Las entradas de moreHours no tienen el campo specialDate, por lo que un día SPECIAL en ellas no lleva fecha.
• Usa moreHours para los horarios secundarios (entrega a domicilio, atención desde el vehículo), con hoursTypeId como clave.

Envía siempre la semana completa. Las plataformas de publicación esperan un horario completo de MONDAY a SUNDAY; envía las siete entradas siempre que establezcas businessHours, usando type: "CLOSED" (con slots vacío) para los días sin actividad en lugar de omitir el día.

Aspectos que debes tener en cuenta.

• El campo identificador es id (el ID de Relay en Base64 que devuelve cada endpoint de lectura).
• Si la validación falla, la llamada sigue devolviendo HTTP 200 con success: false y un array errors con elementos; comprueba siempre success, no solo el código de estado.

Enlaces de acción de la ubicación

placeActionLinks gestiona los botones de acción de Google de una ubicación (pedidos, entrega a domicilio, recogida, reservas, citas). El modelo de escritura es append/upsert, no de sustitución:

• action: "add" (valor predeterminado): añade un enlace nuevo o actualiza uri/isPreferred de un enlace guardado sin sustituirlo.
• action: "delete": elimina un enlace guardado y pone en cola su eliminación de Google.
• Los enlaces que no incluyas en la solicitud se mantienen sin cambios; omitir un enlace nunca lo elimina.

Cómo se identifica un enlace (para editarlo o eliminarlo): por name si está presente; de lo contrario, por placeActionType + uri. Incluye name (obtenido de un endpoint de lectura) cuando lo tengas para identificarlo con la mayor precisión posible; un enlace que aún no se ha sincronizado con Google no tiene name y se identifica por placeActionType + uri.

Valores válidos de placeActionType: APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE. Como máximo, un enlace preferido por tipo.

Cambiar la URL de un enlace = eliminar el antiguo + añadir el nuevo en la misma solicitud:

{  "input": {    "id": "TG9jYXRpb246MTgwMDI4OQ==",    "placeActionLinks": [      { "placeActionType": "FOOD_ORDERING", "uri": "https://order.example.com",     "name": "<link-name-if-synced>", "action": "delete" },      { "placeActionType": "FOOD_ORDERING", "uri": "https://new-order.example.com", "isPreferred": true, "action": "add" }    ]  }}

Justo después de una escritura, name y submissionStatus de un enlace tienen el valor null; se rellenan una vez que el enlace se sincroniza con Google. Consulta la guía de enlaces de acción de la ubicación para conocer el flujo completo, incluido cómo aparecen en discoveredPlaceActionLinks los enlaces descubiertos directamente en Google.