Özellikleri yönetme

Özellikler, işletmelerin erişilebilirlik seçenekleri ve imkanlar gibi ek bilgiler eklemesine olanak tanır.

Kullanılabilir özellikleri (meta veriler) listeleme

Bir işletme kategorisi ve ülke için hangi özelliklerin desteklendiğini öğrenmek istiyorsanız attributes.list isteğinde bulunun. Özellikler dinamiktir ve sık sık alınmalıdır. Aşağıdaki bölümde gösterilen örneğe bakın.

İstek

Belirli bir kategori, bölge kodu ve dil kodu için kullanılabilir özellikleri listelemek istiyorsanız:

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/attributes?regionCode=US&languageCode=EN&categoryName=gcid:restaurant

Belirli bir girişin mevcut özelliklerini yer kodunu kullanarak listelemek için:

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/attributes?parent=locations/{locationId}

Yanıt

Aşağıdaki kısmi yanıt, çeşitli AttributeValueType değerlerine sahip özellik tanımlarını döndürür. valueMetadata, konumun seçili değerlerini değil, izin verilen değerleri ve bunların görünen adlarını açıklar.

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

Bir girişin özelliklerini alma

Belirli bir konum için yapılandırılan özellikleri ve değerleri almak için locations.getAttributes yöntemini kullanın.

Satıcı tarafından yönetilen özellikler

Satıcı tarafından yapılandırılan özellikleri almak için:

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes

Yanıt, konum için ayarlanan gerçek değerleri döndürür:

{
  "name": "locations/{locationId}/attributes",
  "attributes": [
    {
      "name": "attributes/has_wheelchair_accessible_seating",
      "valueType": "BOOL",
      "values": [
        false
      ]
    },
    {
      "name": "attributes/wi_fi",
      "valueType": "ENUM",
      "values": [
        "free_wi_fi"
      ]
    }
  ]
}

Google tarafından güncellenen özellikler (canlı görünüm)

Özellikleri Google Arama ve Haritalar'da canlı olarak göründükleri şekilde (Google güncellemelerini veya kullanıcı tarafından oluşturulan içerikleri içerebilir) almak için locations.attributes.getGoogleUpdated yöntemini kullanın:

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes:getGoogleUpdated

Düzenleme durumuna sahip genişletilmiş özellikler (v1alpha)

Hem satıcı tarafından sağlanan özellikleri hem de tüketiciye yönelik özellikleri, her bir özelliğin düzenleme yaşam döngüsü aşamaları (ör. EDIT_LIFECYCLE_STAGE_PENDING veya EDIT_LIFECYCLE_STAGE_REJECTED), düzenleme kaynağı (SOURCE_API veya SOURCE_UI) ve politika ihlali nedenleriyle birlikte tek bir çağrıda almak için v1alpha içinde locations.attributes.getExtended kullanın:

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

Tam yanıt örnekleri ve özellik düzenleme durumu ile politika ihlallerini yorumlama hakkında ayrıntılı bilgi için Konumlar ve özellikler için düzenleme durumunu kontrol etme başlıklı makaleyi inceleyin.

Giriş için özellik ayarlama

Özellikleri locations.updateAttributes ile ayarlamak için attributeMask parametresini güncellemek istediğiniz özelliklerle ayarlayın.

Aşağıdaki örnekte, bir listeleme için kabul edilen kredi kartı türleri ve teslimat seçeneği özellikleri ayarlanmaktadır.

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=pay_credit_card_types_accepted,has_no_contact_delivery
{
  "name": "locations/{locationId}/attributes",
  "attributes": [
    {
      "name": "has_no_contact_delivery",
      "values": [ true ]
    },
    {
      "name": "pay_credit_card_types_accepted",
      "repeatedEnumValue": {
        "setValues": [
          "american_express",
          "visa"
        ]
      }
    }
  ]
}