Perhatian: Akan ada perubahan besar pada API dalam waktu dekat yang akan memerlukan migrasi. Kunjungi halaman rilis mendatang dan jadwal penghentian kami untuk mendapatkan info terbaru. Anda juga dapat mendaftar ke milis kami untuk menerima info terbaru.

Menambahkan Layanan

Bisnis dapat menambahkan layanan yang disediakan ke listingan GMB 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 GMB mereka. Untuk mengetahui kelayakan, periksa status canModifyServiceList di LocationState.

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://mybusiness.googleapis.com/v4/categories?regionCode=SG&languageCode=EN&searchTerm=salon&view=FULL

Respons

Respons parsial berikut menampilkan semua ServiceTypes yang didukung.

{
    "categories": [
        {
            "displayName": "Hairdresser",
            "categoryId": "gcid:hair_salon",
            "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://mybusiness.googleapis.com/v4/categories:batchGet?regionCode=US&languageCode=en&categoryIds=gcid:electrician&view=FULL

Respons

Respons berisi semua ServiceTypes yang didukung untuk gcid:electrician.

{
    "categories": [
        {
            "displayName": "Electrician",
            "categoryId": "gcid: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.getServiceList.

Permintaan

HTTP
GET https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/serviceList

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.updateServiceList dan updateMask=serviceItems. Memperbarui masing-masing layanan tidak didukung.

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

HTTP
PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/serviceList?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"
            }
         }
      }
   ]
}