Atención: se ha lanzado la versión 4.7 de la API. Consulta el registro de cambios. Las cadenas aún pueden hacer publicaciones relacionadas con el COVID‑19.

Añadir atributos

Los atributos permiten a las empresas incluir información adicional, como opciones de accesibilidad, y añadir enlaces para que los usuarios lleven a cabo acciones.

La captura de pantalla siguiente es un ejemplo de cómo se muestran los atributos en la Búsqueda de Google. Las opciones "Dine in" (Comer allí), "Takeaway" (Para llevar) y "Delivery" (A domicilio) son atributos. Hay otros atributos, como los enlaces para hacer pedidos y consultar el menú.

Enlace para que los usuarios lleven a cabo acciones en un sitio de prueba

Consultar una lista con atributos

Para ver una lista con atributos de una categoría principal y un país concretos, envía una solicitud a attributes.list. Los atributos son dinámicos y se deben consultar periódicamente. En la sección siguiente se muestra un ejemplo.

Solicitud

HTTP
GET https://mybusiness.googleapis.com/v4/attributes?country=US&languageCode=EN&categoryId=gcid:restaurant

Respuesta

La respuesta parcial siguiente devuelve atributos con varios valores AttributeValueType.

{
    {
      "attributeId": "has_live_music",
      "valueType": "BOOL",
      "displayName": "Live music",
      "groupDisplayName": "Highlights",
      "valueMetadata": [
        {
          "value": true,
          "displayName": "Live music"
        }
      ],
      "displayStrings": {
        "uiText": "Live music",
        "standaloneText": "Has live music",
        "negativeText": "No live music"
      }
    },
    {
      "attributeId": "has_wheelchair_accessible_entrance",
      "valueType": "BOOL",
      "displayName": "Wheelchair accessible entrance",
      "groupDisplayName": "Accessibility",
      "valueMetadata": [
        {
          "value": true,
          "displayName": "Wheelchair accessible entrance"
        },
        {
          "value": false,
          "displayName": "No wheelchair accessible entrance"
        }
      ],
      "displayStrings": {
        "uiText": "Wheelchair accessible entrance",
        "standaloneText": "Has wheelchair accessible entrance",
        "negativeText": "No wheelchair accessible entrance"
      }
    },
    {
      "attributeId": "has_braille_menu",
      "valueType": "BOOL",
      "displayName": "Braille menu",
      "groupDisplayName": "Offerings",
      "valueMetadata": [
        {
          "value": true,
          "displayName": "Braille menu"
        }
      ],
      "displayStrings": {
        "uiText": "Braille menu",
        "standaloneText": "Has braille menu",
        "negativeText": "No braille menu"
      }
    },
    {
      "attributeId": "has_no_contact_delivery",
      "valueType": "BOOL",
      "displayName": "No-contact delivery",
      "groupDisplayName": "Offerings",
      "valueMetadata": [
        {
          "value": true,
          "displayName": "No-contact delivery"
        }
      ],
      "displayStrings": {
        "uiText": "No-contact delivery",
        "standaloneText": "Has no-contact delivery",
        "negativeText": "No no-contact delivery"
      }
    },
    {
      "attributeId": "welcomes_lgbtq",
      "valueType": "BOOL",
      "displayName": "LGBTQ friendly",
      "groupDisplayName": "Planning",
      "valueMetadata": [
        {
          "value": true,
          "displayName": "LGBTQ friendly"
        }
      ],
      "displayStrings": {
        "uiText": "LGBTQ friendly",
        "standaloneText": "LGBTQ friendly",
        "negativeText": "Not showing LGBT friendly"
      }
    },
    {
      "attributeId": "wi_fi",
      "valueType": "ENUM",
      "displayName": "Wi-Fi",
      "groupDisplayName": "Amenities",
      "valueMetadata": [
        {
          "value": "free_wi_fi",
          "displayName": "Free"
        },
        {
          "value": "paid_wi_fi",
          "displayName": "Paid"
        }
      ],
      "displayStrings": {
        "uiText": "Wi-Fi",
        "standaloneText": "Has Wi-Fi",
        "negativeText": "No Wi-Fi"
      }
    },
    {
      "attributeId": "pay_credit_card_types_accepted",
      "valueType": "REPEATED_ENUM",
      "displayName": "Credit cards",
      "groupDisplayName": "Payments",
      "isRepeatable": true,
      "valueMetadata": [
        {
          "value": "american_express",
          "displayName": "American Express"
        },
        {
          "value": "china_union_pay",
          "displayName": "China Union Pay"
        },
        {
          "value": "diners_club",
          "displayName": "Diners Club"
        },
        {
          "value": "discover",
          "displayName": "Discover"
        },
        {
          "value": "jcb",
          "displayName": "JCB"
        },
        {
          "value": "mastercard",
          "displayName": "MasterCard"
        },
        {
          "value": "visa",
          "displayName": "VISA"
        }
      ],
      "displayStrings": {
        "uiText": "Credit cards",
        "standaloneText": "Credit cards accepted",
        "negativeText": "Credit cards not accepted"
      }
    },
    {
      "attributeId": "url_menu",
      "valueType": "URL",
      "displayName": "Menu link",
      "groupDisplayName": "Place page URLs",
      "displayStrings": {
        "uiText": "Menu link",
        "standaloneText": "Menu link",
        "negativeText": "No online menu"
      }
    },
    {
      "attributeId": "url_reservations",
      "valueType": "URL",
      "displayName": "Reservations links",
      "groupDisplayName": "Place page URLs",
      "displayStrings": {
        "uiText": "Reservations links",
        "standaloneText": "Reservations links",
        "negativeText": "Table booking not available"
      }
    }
  ]
}

Definir atributos de una ficha

Para definir atributos con accounts.location.patch, añade los parámetros de consulta con updateMask=attributes y añade al parámetro "attributeMask" los atributos que quieras actualizar. Los atributos presentes en attributeMask no se tienen en cuenta si no se encuentran en la ubicación. Para actualizar todos los atributos, deja attributeMask en blanco.

En el ejemplo siguiente, se definen los atributos del enlace para reservar y de la opción de entrega a domicilio de una ficha.

HTTP
PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}?updateMask=attributes&attributeMask=url_reservations,has_no_contact_delivery
{
  "attributes": [
        {
            "attributeId": "has_no_contact_delivery",
            "values": [ true ]
        },
        {
            "attributeId": "url_reservations",
            "urlValues": [
                {
                    "url": "www.abcreservations.com"
                }
            ]
        }
    ]
}