يمكن للأنشطة التجارية إضافة الخدمات التي تقدّمها إلى بيانات ملفاتها التجارية. يمكن أن يشمل ذلك الخدمات المقدمة داخل متجر أو الخدمات المقدمة في مواقع العملاء.
الأهلية والتنسيق
لا يمكن لبعض الأنشطة التجارية إضافة خدمات إلى بطاقة بياناتها على "الملف التجاري". للتأكّد من الأهلية، يُرجى التحقّق من حالة canModifyServiceList
في البيانات الوصفية.
يتم تمثيل الخدمة على أنّها ServiceItem، والتي تتوافق مع التنسيقَين التاليَين:
- StructuredServiceItem: يمكن تمثيل خدمات Google المحدَّدة مسبقًا على أنها
StructuredServiceItem
، تحتوي علىserviceTypeId
. - FreeFormServiceItem: لتقديم خدمات مخصّصة، استخدِم سمة
FreeFormServiceItem
التي تحتوي على تصنيف.
بطاقة بيانات خدمات محدّدة مسبقًا حسب اسم الفئة
للبحث عن الخدمات المحدَّدة مسبقًا ضمن فئة حسب اسم الفئة، استخدِم categories.list. يظهر في قسم "الطلب" التالي طلب لجميع الفئات التي تتضمن الاسم salon
في سنغافورة.
الطلب
يجب ضبط CategoryView على FULL
.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
الإجابة
تعرض الاستجابة الجزئية التالية جميع ServiceTypes المتوافقة.
{ "categories": [ { "name": "gcid:hair_salon", "displayName": "Hairdresser", "serviceTypes": [ { "serviceTypeId": "job_type_id:body_waxing", "displayName": "Body Waxing" }, { "serviceTypeId": "job_type_id:hair_coloring", "displayName": "Hair coloring" }, { "serviceTypeId": "job_type_id:hair_extensions", "displayName": "Hair extensions" }, { "serviceTypeId": "job_type_id:hair_styling", "displayName": "Hair styling" }, { "serviceTypeId": "job_type_id:manicures", "displayName": "Manicures" }, { "serviceTypeId": "job_type_id:pedicures", "displayName": "Pedicures" } ] } }
سرد الخدمات المحددة مسبقًا حسب رقم تعريف الفئة
للبحث عن الخدمات المحدَّدة مسبقًا حسب معرّف فئة معيّنة، استخدِم categories.batchGet. يظهر في قسم "الطلب" التالي طلب للحصول على تفاصيل ضمن معرّف الفئة gcid:electrician
في الولايات المتحدة.
الطلب
يجب ضبط CategoryView على FULL
.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
الإجابة
يحتوي الرد على جميع ServiceTypes المتوافقة لـ gcid:electrician
.
{ "categories": [ { "name": "gcid:electrician", "displayName": "Electrician", "serviceTypes": [ { "serviceTypeId": "job_type_id:construction", "displayName": "Construction" }, { "serviceTypeId": "job_type_id:electric_car_charger", "displayName": "Install electric car charger" }, { "serviceTypeId": "job_type_id:electrician_remodeling", "displayName": "Remodeling" }, { "serviceTypeId": "job_type_id:general_repairs", "displayName": "General repairs" }, { "serviceTypeId": "job_type_id:install_fan", "displayName": "Install fan" }, { "serviceTypeId": "job_type_id:install_ground_wire", "displayName": "Install ground wire" }, { "serviceTypeId": "job_type_id:install_light_fixtures", "displayName": "Install light fixtures" }, { "serviceTypeId": "job_type_id:install_outdoor_lighting", "displayName": "Install outdoor lighting" }, { "serviceTypeId": "job_type_id:install_outlets_switches", "displayName": "Install outlets or switches" }, { "serviceTypeId": "job_type_id:install_security_system", "displayName": "Install security system" }, { "serviceTypeId": "job_type_id:installation", "displayName": "Installation" }, { "serviceTypeId": "job_type_id:relocate_outlets_switches", "displayName": "Relocate outlets or switches" }, { "serviceTypeId": "job_type_id:repair_fan", "displayName": "Repair fan" }, { "serviceTypeId": "job_type_id:repair_light_fixtures", "displayName": "Repair light fixtures" }, { "serviceTypeId": "job_type_id:repair_outlets_switches", "displayName": "Repair outlets or switches" }, { "serviceTypeId": "job_type_id:repair_panel", "displayName": "Repair panel" }, { "serviceTypeId": "job_type_id:replace_upgrade_panel", "displayName": "Replace or upgrade panel" }, { "serviceTypeId": "job_type_id:restore_power", "displayName": "Restore power" } ] } ] }
إدراج الخدمات الحالية في بطاقة بيانات
للحصول على قائمة حالية بالخدمات، استخدِم locations.get وعيِّنهاreadMask=serviceItems
الطلب
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
الإجابة
فيما يلي نموذج للرد
{ "serviceItems": [ { "structuredServiceItem": { "serviceTypeId": "job_type_id:hair_coloring" } }, { "isOffered": true, "structuredServiceItem": { "serviceTypeId": "job_type_id:hair_styling" } }, { "isOffered": true, "freeFormServiceItem": { "categoryId": "gcid:barber_shop", "label": { "displayName": "Student Cuts" } } } ] }
تعيين خدمات لبطاقة بيانات
لتحديث الخدمات، استخدِم locations.patch وupdateMask=serviceItems
. تحديث الخدمات الفردية غير متاح.
لضبط الخدمات باستخدام StructuredServiceItem وFreeFormServiceItem، يمكنك الاطّلاع على المثال التالي:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=serviceItems { "serviceItems":[ { "isOffered":false, "structuredServiceItem":{ "serviceTypeId":"job_type_id:hair_coloring" } }, { "isOffered":true, "structuredServiceItem":{ "serviceTypeId":"job_type_id:hair_styling" } }, { "isOffered":true, "freeFormServiceItem":{ "categoryId":"gcid:hair_salon", "label":{ "displayName":"Student Cuts" } } } ] }