Important : La version 4.7 de l'API a été publiée. Consultez le journal des modifications. Les chaînes d'établissements sont toujours autorisées temporairement à créer des posts en rapport avec le COVID-19.

Ajouter des attributs

En définissant des attributs, les établissements peuvent inclure des informations supplémentaires (des détails sur l'accessibilité ou des liens Place Action, par exemple).

La capture d'écran suivante vous montre comment les attributs apparaissent dans la recherche Google. Les options "Dine-in" (Repas sur place), "Takeaway" (À emporter) et "Delivery" (Livraison) sont des attributs. Les autres attributs incluent les liens "Order" (Commander) et "Menu".

Lien

Attributs des fiches

Pour afficher la liste des attributs disponibles pour une catégorie principale et un pays, envoyez une requête attributes.list. Les attributs étant dynamiques, ils doivent être récupérés régulièrement. Consultez l'exemple dans la section suivante.

Requête

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

Réponse

La réponse partielle suivante renvoie des attributs avec différentes valeurs 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"
      }
    }
  ]
}

Définir les attributs d'une fiche

Pour définir des attributs avec accounts.location.patch, ajoutez les paramètres de requête avec updateMask=attributes, puis définissez le paramètre "attributeMask" avec les attributs que vous souhaitez mettre à jour. Les attributs présents dans attributeMask sont ignorés s'ils ne sont pas associés à l'établissement. Pour mettre à jour tous les attributs, laissez le champ attributeMask vide.

Dans l'exemple de code suivant, les attributs de lien de réservation et d'options de livraison sont définis pour une fiche.

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"
                }
            ]
        }
    ]
}