Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
ServiceList
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
하나 이상의 서비스 항목이 포함된 서비스 목록입니다.
| JSON 표현 |
{
"name": string,
"serviceItems": [
{
object (ServiceItem)
}
]
} |
| 필드 |
name |
string
필수 항목입니다. 이 위치의 Google 식별자입니다. accounts/{accountId}/locations/{locationId}/serviceList 형식입니다.
|
serviceItems[] |
object (ServiceItem)
이 서비스 목록에 포함된 서비스 항목입니다. 중복된 서비스 항목은 자동으로 삭제됩니다.
|
ServiceItem
단일 서비스 항목을 설명하는 메시지입니다. 판매자가 제공하는 서비스 유형을 설명하는 데 사용됩니다. 예를 들어, 이발은 서비스가 될 수 있습니다.
| JSON 표현 |
{
"isOffered": boolean,
"price": {
object (Money)
},
// Union field service_item_info can be only one of the following:
"structuredServiceItem": {
object (StructuredServiceItem)
},
"freeFormServiceItem": {
object (FreeFormServiceItem)
}
// End of list of possible types for union field service_item_info.
} |
| 필드 |
isOffered |
boolean
선택사항입니다. 이 필드는 판매자가 입력 서비스를 제공하는지 여부를 결정합니다.
|
price |
object (Money)
선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 통화 코드 및 단위를 설정하는 것이 좋습니다.
|
통합 필드 service_item_info. 다음 필드 중 하나를 항상 설정해야 합니다. service_item_info은 다음 중 하나여야 합니다. |
structuredServiceItem |
object (StructuredServiceItem)
이 필드는 구조화된 서비스 데이터의 케이스가 설정됩니다.
|
freeFormServiceItem |
object (FreeFormServiceItem)
자유 형식 서비스 데이터의 경우 이 필드가 설정됩니다.
|
StructuredServiceItem
판매자가 제공하는 구조화된 서비스를 나타냅니다. 예: toilet_installation.
| JSON 표현 |
{
"serviceTypeId": string,
"description": string
} |
| 필드 |
serviceTypeId |
string
필수 항목입니다. serviceTypeId 필드는 Google에서 제공하는 고유 ID로 ServiceTypeMetadata에서 확인할 수 있습니다. 이 정보는 category.batchGet RPC 서비스에서 제공합니다.
|
description |
string
선택사항입니다. 구조화된 서비스 항목의 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eA service list allows businesses to display the services they offer, containing one or more service items with details like price and availability.\u003c/p\u003e\n"],["\u003cp\u003eService items can be structured, using predefined service types, or free-form, allowing custom service descriptions.\u003c/p\u003e\n"],["\u003cp\u003eStructured service items utilize a \u003ccode\u003eserviceTypeId\u003c/code\u003e for categorization, while free-form items rely on a \u003ccode\u003ecategoryId\u003c/code\u003e and custom labels.\u003c/p\u003e\n"],["\u003cp\u003eEach service item can include a price and indicate whether it's currently offered by the business.\u003c/p\u003e\n"],["\u003cp\u003eService lists are identified by a unique Google identifier associated with a specific location.\u003c/p\u003e\n"]]],["The content defines a service list, which contains multiple service items. Each service item can be structured or free-form, and includes details like whether it's offered (`isOffered`) and its price. Structured items have a `serviceTypeId` and optional description, while free-form items require a `categoryId` and a `label`. Service list `name` is a Google identifier and it has an array of `serviceItems`. `service_item_info` must include one type of service `structuredServiceItem` or `freeFormServiceItem`.\n"],null,["# ServiceList\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ServiceItem](#ServiceItem)\n - [JSON representation](#ServiceItem.SCHEMA_REPRESENTATION)\n- [StructuredServiceItem](#StructuredServiceItem)\n - [JSON representation](#StructuredServiceItem.SCHEMA_REPRESENTATION)\n- [FreeFormServiceItem](#FreeFormServiceItem)\n - [JSON representation](#FreeFormServiceItem.SCHEMA_REPRESENTATION)\n\nA service list containing one or more service items.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"serviceItems\": [ { object (/my-business/reference/rest/v4/ServiceList#ServiceItem) } ] } ``` |\n\n| Fields ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Google identifier for this location in the form: `accounts/{accountId}/locations/{locationId}/serviceList` |\n| `serviceItems[]` | `object (`[ServiceItem](/my-business/reference/rest/v4/ServiceList#ServiceItem)`)` Service items that are contained within this service list. Duplicated service items will be removed automatically. |\n\nServiceItem\n-----------\n\nA message that describes a single service item. It is used to describe the type of service that the merchant provides. For example, haircut can be a service.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"isOffered\": boolean, \"price\": { object (/my-business/reference/rest/v4/accounts.locations#Location.Money) }, // Union field `service_item_info` can be only one of the following: \"structuredServiceItem\": { object (/my-business/reference/rest/v4/ServiceList#StructuredServiceItem) }, \"freeFormServiceItem\": { object (/my-business/reference/rest/v4/ServiceList#FreeFormServiceItem) } // End of list of possible types for union field `service_item_info`. } ``` |\n\n| Fields ||\n|-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| `isOffered` | `boolean` Optional. This field decides whether or not the input service is offered by the merchant. |\n| `price` | `object (`[Money](/my-business/reference/rest/v4/accounts.locations#Location.Money)`)` Optional. Represents the monetary price of the service item. We recommend that currencyCode and units should be set when including a price. |\n| Union field `service_item_info`. One of the following fields should always be set. `service_item_info` can be only one of the following: |||\n| `structuredServiceItem` | `object (`[StructuredServiceItem](/my-business/reference/rest/v4/ServiceList#StructuredServiceItem)`)` This field will be set case of structured services data. |\n| `freeFormServiceItem` | `object (`[FreeFormServiceItem](/my-business/reference/rest/v4/ServiceList#FreeFormServiceItem)`)` This field will be set case of free-form services data. |\n\nStructuredServiceItem\n---------------------\n\nRepresents a structured service offered by the merchant. For eg: toilet_installation.\n\n| JSON representation ||\n|------------------------------------------------------------|---|\n| ``` { \"serviceTypeId\": string, \"description\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `serviceTypeId` | `string` Required. The `serviceTypeId` field is a Google provided unique ID that can be found in `ServiceTypeMetadata`. This information is provided by categories.batchGet rpc service. |\n| `description` | `string` Optional. Description of structured service item. The character limit is 300. |\n\nFreeFormServiceItem\n-------------------\n\nRepresents a free-form service offered by the merchant. These are services that are not exposed as part of our structure service data. The merchant manually enters the names for of such services via a geomerchant surface.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"categoryId\": string, \"label\": { object (/my-business/reference/rest/v4/accounts.locations#Location.Label) } } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `categoryId` | `string` Required. The `categoryId` and `serviceTypeId` should match the possible combinations provided in the `Category` message. |\n| `label` | `object (`[Label](/my-business/reference/rest/v4/accounts.locations#Location.Label)`)` Required. Language-tagged labels for the item. We recommend that item names be 140 characters or less, and descriptions 250 characters or less. This field should only be set if the input is a custom service item. Standardized service types should be updated via serviceTypeId. |"]]
