API Business Information

Registro de cambios

Versión 1

Acceso a la API

Se debe habilitar la API Business Information en la consola de GCP. El alcance de OAuth sigue siendo el mismo.

URL de punto final

Para acceder a los puntos finales de toda la información, los atributos, las categorías, las cadenas y las búsquedas de ubicaciones de la empresa, usa https://mybusinessbusinessinformation.googleapis.com/v1/ en lugar de https://mybusiness.googleapis.com/v4/.

El nombre de la ruta de los puntos finales de las ubicaciones ha cambiado de accounts/accountId/locations/locationId a locations/locationId.

Actualizaciones de ubicaciones

  • Se ha cambiado el nombre de locationName a title.
  • Se ha cambiado el nombre de websiteUrl a websiteUri.
  • Ahora accounts.locations.list y locations.get requieren un parámetro readMask.
  • Ahora primaryPhone y additionalPhones forman parte de PhoneNumbers.
  • Ahora primaryCategory y additionalCategories forman parte de Categories.
  • Se ha cambiado el nombre de address a storefrontAddress.
  • accounts.locations.clearAssociation se ha sustituido por locations.clearLocationAssociation.
  • serviceItems ahora se lee y actualiza directamente desde el objeto Location.

Atributos

  • El nuevo objeto Attributes y el punto final correspondiente, locations.attributes.getGoogleUpdated, para obtener la versión actualizada de Google.
  • attributes.list tiene un parámetro show_all que permite a los clientes ver los atributos que se pueden definir para una combinación concreta de categoría y región.

Empresas de servicios locales

  • Las empresas de tipo CUSTOMER_LOCATION_ONLY ya no tienen que rellenar una dirección.
  • Se ha añadido regionCode a ServiceAreaBusiness. Debe definirse para empresas de tipo CUSTOMER_LOCATION_ONLY.

Objetos y puntos finales no disponibles

  • Se ha eliminado el objeto LocationKey. Los campos que ya tiene se han movido a Metadata.
  • Se ha eliminado el objeto PriceLists. Se ha sustituido por FoodMenus y ServiceLists.
  • Se ha eliminado el objeto LocationState. La mayoría de los campos que ya tiene se han movido a Metadata. Aunque Metadata contiene un valor booleano para determinar si el comerciante tiene control total sobre la empresa (voz del comerciante), se han movido los campos relacionados más detallados de suspensión y verificación a la API Verifications. Usa el método locations.getVoiceOfMerchantState para dar los siguientes pasos y obtener la voz del comerciante.
  • Los puntos finales googleLocations.report y accounts.locations.findMatchingLocations ya no están disponibles.
  • El punto final TransferLocation se ha movido a locations.transfer, disponible en la API Account Management.