إدارة السمات

تتيح السمات للمؤسسات تضمين معلومات إضافية، مثل خيارات تسهيل الاستخدام ووسائل الراحة.

عرض السمات المتاحة (البيانات الوصفية)

لمعرفة السمات المتوافقة مع فئة نشاط تجاري وبلد معيّنَين، يمكنك طلب attributes.list. السمات ديناميكية ويجب استردادها بشكل متكرر. انظر المثال الموضح في القسم التالي.

طلب

لإدراج السمات المتاحة لفئة معيّنة ورمز منطقة ورمز لغة معيّنَين:

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

لإدراج السمات المتاحة لبطاقة بيانات معيّنة باستخدام معرّف الموقع الجغرافي:

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

الردّ

يعرض الردّ الجزئي التالي تعريفات السمات بقيم مختلفة لـ AttributeValueType. يُرجى العِلم أنّ السمة valueMetadata تصف القيم المسموح بها وأسماء العرض الخاصة بها، وليس القيم المحدّدة للموقع الجغرافي.

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

الحصول على سمات بيانات معيّنة

لاسترداد السمات والقيم التي تم ضبطها لموقع جغرافي معيّن، استخدِم locations.getAttributes.

السمات التي يديرها التجّار

للحصول على السمات التي ضبطها التاجر:

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

تعرض الاستجابة القيم الفعلية المحدّدة للموقع الجغرافي:

{
  "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 (العرض المباشر)

لاسترداد السمات كما تظهر مباشرةً على "بحث Google" و"خرائط Google" (والتي قد تتضمّن تعديلات من Google أو محتوى من إنشاء المستخدمين)، استخدِم locations.attributes.getGoogleUpdated:

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

السمات الموسّعة مع حالة التعديل (v1alpha)

لاسترداد كل من السمات التي يقدّمها التاجر والسمات التي تظهر للمستهلكين، بالإضافة إلى مراحل دورة حياة التعديل لكل سمة (مثل EDIT_LIFECYCLE_STAGE_PENDING أو EDIT_LIFECYCLE_STAGE_REJECTED) ومصدر التعديل (SOURCE_API أو SOURCE_UI) وأسباب انتهاك السياسة في طلب واحد، استخدِم locations.attributes.getExtended في v1alpha:

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

للاطّلاع على أمثلة كاملة على الردود وتفاصيل حول تفسير حالة تعديل السمات وانتهاكات السياسات، يُرجى الاطّلاع على التحقّق من حالة التعديل للمواقع الجغرافية والسمات.

ضبط سمات بطاقة بيانات متجر

لضبط السمات باستخدام locations.updateAttributes، اضبط المَعلمة attributeMask على السمات التي تريد تعديلها.

يحدّد المثال التالي أنواع بطاقات الائتمان المقبولة وسمات خيارات التسليم لبيانات المنتج.

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