Achtung: Version 4.7 der API wurde veröffentlicht. Siehe Änderungsprotokoll. Beiträge mit einem Bezug zur Coronakrise sind für Handelsketten weiterhin vorübergehend zulässig.

Attribute hinzufügen

Mithilfe von Attributen können Unternehmen ihrem Eintrag zusätzliche Informationen, etwa zur Barrierefreiheit, und Place Action-Links hinzufügen.

Im folgenden Screenshot sehen Sie, wie Attribute in der Google Suche erscheinen. Die Optionen "Speisen vor Ort", "Zum Mitnehmen" und "Lieferdienst" sind Attribute. Weitere mögliche Attribute sind Links zum Bestellen und zu Speisekarten.

Place Action-Links testen

Attribute abrufen

Wenn Sie eine Liste der Attribute für eine primäre Kategorie und ein Land abrufen möchten, müssen Sie einen attributes.list-Aufruf starten. Attribute sind dynamisch und sollten häufig abgerufen werden. Im nächsten Abschnitt sehen Sie ein Beispiel.

Anfrage

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

Antwort

In der folgenden partiellen Antwort werden Attribute mit verschiedenen AttributeValueType-Werten zurückgegeben.

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

Attribute für einen Eintrag festlegen

Wenn Sie Attribute mit accounts.location.patch festlegen möchten, fügen Sie die Abfrageparameter mit updateMask=attributes hinzu und geben Sie im Parameter "attributeMask" die Attribute an, die Sie aktualisieren möchten. Attribute, die in attributeMask angegeben werden, aber nicht am Standort vorhanden sind, werden ignoriert. Wenn Sie alle Attribute aktualisieren möchten, lassen Sie attributeMask leer.

Im folgenden Beispiel werden die Attribute für den Reservierungslink und für die Lieferoption bei einem Eintrag festgelegt.

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