Perbarui integrasi Google Business Profile API Anda sebelum endpoint penting dinonaktifkan. Tinjau jadwal penghentian dan petunjuk untuk menghindari gangguan mulai April 2022.

Menambahkan Layanan

Bisnis dapat menambahkan layanan yang disediakan ke listingan Profil Bisnis mereka. Hal ini dapat mencakup layanan yang disediakan dalam toko atau yang ditawarkan di lokasi pelanggan.

Kelayakan dan Format

Tidak semua bisnis dapat menambahkan layanan ke listingan Profil Bisnis mereka. Untuk mengetahui kelayakan, periksa status canModifyServiceList di Metadata.

Layanan direpresentasikan sebagai ServiceItem, yang mendukung dua format berikut:

  • StructuredServiceItem: Layanan standar Google dapat direpresentasikan sebagai StructuredServiceItem, yang berisi serviceTypeId.
  • FreeFormServiceItem: Untuk menawarkan layanan kustom, gunakan FreeFormServiceItem yang berisi Label.

Menampilkan daftar layanan standar berdasarkan nama kategori

Untuk menelusuri layanan standar dalam kategori berdasarkan nama kategori, gunakan categories.list. Permintaan untuk semua kategori yang menyertakan nama salon di Singapura ditampilkan di bagian Permintaan berikut.

Permintaan

CategoryView harus ditetapkan ke FULL.

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL

Respons

Respons parsial berikut menampilkan semua ServiceTypes yang didukung.

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

Menampilkan daftar layanan standar berdasarkan ID kategori

Untuk menelusuri layanan standar berdasarkan ID kategori tertentu, gunakan categories.batchGet. Permintaan untuk detail berdasarkan ID kategori gcid:electrician di Amerika Serikat ditampilkan di bagian Permintaan berikut.

Permintaan

CategoryView harus ditetapkan ke FULL.

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL

Respons

Respons berisi semua ServiceTypes yang didukung untuk 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"
                }
            ]
        }
    ]
}

Menampilkan daftar layanan yang ada di listingan

Untuk mendapatkan daftar layanan saat ini, gunakan locations.get dan tetapkanreadMask=serviceItems

Permintaan

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

Respons

Berikut adalah contoh respons

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

Menetapkan layanan untuk listingan

Untuk memperbarui layanan, gunakan locations.patch dan updateMask=serviceItems. Memperbarui masing-masing layanan tidak didukung.

Untuk menetapkan layanan dengan StructuredServiceItem dan FreeFormServiceItem, lihat contoh berikut:

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