색인
AccessControl
(인터페이스)(지원 중단됨)Accounts
(인터페이스)(지원 중단됨)BusinessCategories
(인터페이스)BusinessMessagingService
(인터페이스)Followers
(인터페이스)FoodMenuService
(인터페이스)GoogleLocations
(인터페이스)HealthProviderAttributesService
(인터페이스)Insights
(인터페이스)InsuranceNetworkService
(인터페이스)LocalPosts
(인터페이스)Locations
(인터페이스)Media
(인터페이스)QuestionsAndAnswers
(인터페이스)Reviews
(인터페이스)ServiceLists
(인터페이스)Verifications
(인터페이스)AcceptInvitationRequest
(메시지)Account
(메시지)(지원 중단됨)Account.OrganizationInfo
(메시지)AccountRole
(열거형)AccountState
(메시지)AccountState.AccountStatus
(열거형)AccountType
(열거형)AdWordsLocationExtensions
(메시지)AddressInput
(메시지)Admin
(메시지)Admin.AdminRole
(열거형)AlertType
(열거형)Allergen
(열거형)Answer
(메시지)AssociateLocationRequest
(메시지)Attribute
(메시지)AttributeMetadata
(메시지)AttributeMetadata.AttributeValueMetadata
(메시지)AttributeValueType
(열거형)Author
(메시지)Author.AuthorType
(열거형)BasicMetricsRequest
(메시지)BatchGetBusinessCategoriesRequest
(메시지)BatchGetBusinessCategoriesResponse
(메시지)BatchGetLocationsRequest
(메시지)BatchGetLocationsResponse
(메시지)BatchGetReviewsRequest
(메시지)BatchGetReviewsResponse
(메시지)BusinessHours
(메시지)CallToAction
(메시지)CallToAction.ActionType
(열거형)Category
(메시지)CategoryView
(열거형)Chain
(메시지)Chain.ChainName
(메시지)Chain.ChainUrl
(메시지)ClearLocationAssociationRequest
(메시지)CompleteVerificationRequest
(메시지)CompleteVerificationResponse
(메시지)CreateAccountAdminRequest
(메시지)CreateAccountRequest
(메시지)CreateLocalPostRequest
(메시지)CreateLocationAdminRequest
(메시지)CreateLocationRequest
(메시지)CreateMediaItemRequest
(메시지)CreateQuestionRequest
(메시지)DeclineInvitationRequest
(메시지)DeleteAccountAdminRequest
(메시지)DeleteAnswerRequest
(메시지)DeleteLocalPostRequest
(메시지)DeleteLocationAdminRequest
(메시지)DeleteLocationRequest
(메시지)DeleteMediaItemRequest
(메시지)DeleteNotificationsRequest
(메시지)DeleteQuestionRequest
(메시지)DeleteReviewReplyRequest
(메시지)DietaryRestriction
(열거형)DimensionalMetricValue
(메시지)DimensionalMetricValue.TimeDimension
(메시지)DrivingDirectionMetricsRequest
(메시지)DrivingDirectionMetricsRequest.NumDays
(열거형)EmailInput
(메시지)ErrorDetail
(메시지)ErrorDetail.ErrorCode
(열거형)FetchVerificationOptionsRequest
(메시지)FetchVerificationOptionsResponse
(메시지)FindMatchingLocationsRequest
(메시지)FindMatchingLocationsResponse
(메시지)FollowersMetadata
(메시지)FoodMenu
(메시지)FoodMenu.Cuisine
(열거형)FoodMenuItem
(메시지)FoodMenuItemAttributes
(메시지)FoodMenuItemAttributes.Ingredient
(메시지)FoodMenuItemAttributes.PortionSize
(메시지)FoodMenuItemOption
(메시지)FoodMenuSection
(메시지)FoodMenus
(메시지)GenerateAccountNumberRequest
(메시지)GetAccountRequest
(메시지)GetChainRequest
(메시지)GetCustomerMediaItemRequest
(메시지)GetFollowersMetadataRequest
(메시지)GetFoodMenusRequest
(메시지)GetHealthProviderAttributesRequest
(메시지)GetLocalPostRequest
(메시지)GetLocationRequest
(메시지)GetMediaItemRequest
(메시지)GetNotificationsRequest
(메시지)GetReviewRequest
(메시지)GetServiceListRequest
(메시지)GoogleLocation
(메시지)GoogleUpdatedLocation
(메시지)HealthProviderAttributes
(메시지)InsuranceNetwork
(메시지)InternalError
(메시지)Invitation
(메시지)Invitation.TargetLocation
(메시지)ListAccountAdminsRequest
(메시지)ListAccountAdminsResponse
(메시지)ListAccountsRequest
(메시지)ListAccountsResponse
(메시지)ListAnswersRequest
(메시지)ListAnswersResponse
(메시지)ListAttributeMetadataRequest
(메시지)ListAttributeMetadataResponse
(메시지)ListBusinessCategoriesRequest
(메시지)ListBusinessCategoriesResponse
(메시지)ListCustomerMediaItemsRequest
(메시지)ListCustomerMediaItemsResponse
(메시지)ListInsuranceNetworksRequest
(메시지)ListInsuranceNetworksResponse
(메시지)ListInvitationsRequest
(메시지)ListInvitationsRequest.TargetType
(열거형)ListInvitationsResponse
(메시지)ListLocalPostsRequest
(메시지)ListLocalPostsResponse
(메시지)ListLocationAdminsRequest
(메시지)ListLocationAdminsResponse
(메시지)ListLocationsRequest
(메시지)ListLocationsResponse
(메시지)ListMediaItemsRequest
(메시지)ListMediaItemsResponse
(메시지)ListQuestionsRequest
(메시지)ListQuestionsResponse
(메시지)ListRecommendedGoogleLocationsRequest
(메시지)ListRecommendedGoogleLocationsResponse
(메시지)ListReviewsRequest
(메시지)ListReviewsResponse
(메시지)ListVerificationsRequest
(메시지)ListVerificationsResponse
(메시지)LocalPost
(메시지)LocalPost.LocalPostState
(열거형)LocalPostEvent
(메시지)LocalPostMetrics
(메시지)LocalPostOffer
(메시지)LocalPostTopicType
(열거형)Location
(메시지)Location.Metadata
(메시지)Location.Metadata.Duplicate
(메시지)Location.Metadata.Duplicate.Access
(열거형)Location.RelationshipData
(메시지)LocationDrivingDirectionMetrics
(메시지)LocationDrivingDirectionMetrics.TopDirectionSources
(메시지)LocationDrivingDirectionMetrics.TopDirectionSources.RegionCount
(메시지)LocationKey
(메시지)LocationMetrics
(메시지)LocationReview
(메시지)LocationState
(메시지)MatchedLocation
(메시지)MediaItem
(메시지)MediaItem.Attribution
(메시지)MediaItem.Dimensions
(메시지)MediaItem.LocationAssociation
(메시지)MediaItem.LocationAssociation.Category
(열거형)MediaItem.MediaFormat
(열거형)MediaItem.MediaInsights
(메시지)MediaItemDataRef
(메시지)MenuLabel
(메시지)Metric
(열거형)MetricOption
(열거형)MetricRequest
(메시지)MetricValue
(메시지)MoreHours
(메시지)MoreHoursType
(메시지)NetworkState
(열거형)NotificationType
(열거형)Notifications
(메시지)NutritionFacts
(메시지)NutritionFacts.CaloriesFact
(메시지)NutritionFacts.EnergyUnit
(열거형)NutritionFacts.MassUnit
(열거형)NutritionFacts.NutritionFact
(메시지)OpenInfo
(메시지)OpenInfo.OpenForBusiness
(열거형)PermissionLevel
(열거형)PhoneInput
(메시지)PlaceInfo
(메시지)Places
(메시지)PointRadius
(메시지)PreparationMethod
(열거형)PriceList
(메시지)(지원 중단됨)PriceList.Label
(메시지)PriceList.Section
(메시지)PriceList.Section.Item
(메시지)PriceList.Section.SectionType
(열거형)Profile
(메시지)Question
(메시지)RepeatedEnumAttributeValue
(메시지)ReportGoogleLocationRequest
(메시지)ReportGoogleLocationRequest.BadLocationReason
(열거형)ReportGoogleLocationRequest.BadRecommendationReason
(열거형)ReportLocalPostInsightsRequest
(메시지)ReportLocalPostInsightsResponse
(메시지)ReportLocationInsightsRequest
(메시지)ReportLocationInsightsResponse
(메시지)Review
(메시지)Review.Reviewer
(메시지)Review.StarRating
(열거형)ReviewReply
(메시지)SearchChainsRequest
(메시지)SearchChainsResponse
(메시지)SearchGoogleLocationsRequest
(메시지)SearchGoogleLocationsResponse
(메시지)ServiceAreaBusiness
(메시지)ServiceAreaBusiness.BusinessType
(열거형)ServiceBusinessContext
(메시지)ServiceList
(메시지)ServiceList.ServiceItem
(메시지)ServiceList.ServiceItem.FreeFormServiceItem
(메시지)ServiceList.ServiceItem.StructuredServiceItem
(메시지)ServiceType
(메시지)SpecialHourPeriod
(메시지)SpecialHours
(메시지)Spiciness
(열거형)StartUploadMediaItemDataRequest
(메시지)TimeInterval
(메시지)TimePeriod
(메시지)TimeRange
(메시지)TransferLocationRequest
(메시지)UpdateAccountAdminRequest
(메시지)UpdateAccountRequest
(메시지)UpdateFoodMenusRequest
(메시지)UpdateHealthProviderAttributesRequest
(메시지)UpdateLocalPostRequest
(메시지)UpdateLocationAdminRequest
(메시지)UpdateLocationRequest
(메시지)UpdateMediaItemRequest
(메시지)UpdateNotificationsRequest
(메시지)UpdateQuestionRequest
(메시지)UpdateReviewReplyRequest
(메시지)UpdateServiceListRequest
(메시지)UpsertAnswerRequest
(메시지)UrlAttributeValue
(메시지)ValidationError
(메시지)Verification
(메시지)Verification.VerificationState
(열거형)VerificationMethod
(열거형)VerificationOption
(메시지)VerificationOption.AddressVerificationData
(메시지)VerificationOption.EmailVerificationData
(메시지)VerificationOption.PhoneVerificationData
(메시지)VerifyLocationRequest
(메시지)VerifyLocationResponse
(메시지)
AccessControl
이 서비스를 사용하면 계정 및 위치에 액세스할 수 있는 사용자를 관리할 수 있습니다.
AcceptInvitation | |
---|---|
지정된 초대를 수락합니다.
|
CreateAccountAdmin | |
---|---|
지정된 사용자를 지정된 계정의 관리자로 초대합니다. 초대를 받은 사용자가 초대를 수락해야 계정에 대한 액세스 권한이 부여됩니다. 프로그래매틱 방식으로 초대를 수락하려면 [AcceptInvitation] [google.mybusiness.v4.AcceptInvitation] 을 참조하세요.
|
CreateLocationAdmin | |
---|---|
지정된 사용자를 지정된 위치의 관리자로 초대합니다. 초대를 받은 사용자가 초대를 수락해야 위치에 대한 액세스 권한이 부여됩니다. 프로그래매틱 방식으로 초대를 수락하려면 [AcceptInvitation] [google.mybusiness.v4.AcceptInvitation] 을 참조하세요.
|
DeclineInvitation | |
---|---|
지정된 초대를 거부합니다.
|
DeleteAccountAdmin | |
---|---|
지정된 계정에서 지정된 관리자를 삭제합니다.
|
DeleteLocationAdmin | |
---|---|
지정된 위치의 관리자로 지정된 관리자를 삭제합니다.
|
ListAccountAdmins | |
---|---|
지정된 계정의 관리자를 나열합니다.
|
ListInvitations | |
---|---|
지정된 계정의 대기 중인 초대를 나열합니다.
|
ListLocationAdmins | |
---|---|
지정된 위치의 모든 관리자를 나열합니다.
|
UpdateAccountAdmin | |
---|---|
지정된 계정 관리자의 관리자를 업데이트합니다. 관리자의 AdminRole만 업데이트할 수 있습니다.
|
UpdateLocationAdmin | |
---|---|
지정된 위치 관리자의 관리자를 업데이트합니다. 관리자의 AdminRole만 업데이트할 수 있습니다.
|
계정
이 API를 사용하면 Google에서 비즈니스 계정을 관리할 수 있습니다. 이를 통해 Account
리소스를 관리할 수 있습니다. 이 클래스는 다음과 같은 리소스 모델을 정의합니다.
API에는
accounts/*
라는Account
리소스 컬렉션이 있습니다.편의상 인증된 발신자의 개인 계정에 대한 계정 ID 대신 동의어 'me'를 사용할 수도 있습니다. 예: GET /v4/accounts/me GET /v4/accounts/me/locations
CreateAccount | |
---|---|
지정된 상위 항목에 지정된 이름과 유형의 계정을 만듭니다.
|
DeleteNotifications | |
---|---|
계정의 Pub/Sub 알림 설정을 지웁니다.
|
GenerateAccountNumber | |
---|---|
이 계정의 계좌 번호를 생성합니다. 계정을 만들 때 계좌 번호가 프로비저닝되지 않습니다. 필요한 경우 이 요청을 사용하여 계좌 번호를 만듭니다.
|
GetAccount | |
---|---|
지정된 계정을 가져옵니다. 계정이 없거나 호출자에게 계정 액세스 권한이 없는 경우
|
GetNotifications | |
---|---|
계정의 Pub/Sub 알림 설정을 반환합니다.
|
ListAccounts | |
---|---|
인증된 사용자의 모든 계정을 나열합니다. 여기에는 사용자가 소유한 모든 계정과 사용자가 관리 권한을 보유한 계정이 포함됩니다.
|
UpdateAccount | |
---|---|
지정된 비즈니스 계정을 업데이트합니다. 이 방법으로는 개인 계정을 업데이트할 수 없습니다.
|
UpdateNotifications | |
---|---|
비즈니스 프로필에 Pub/Sub 알림을 보낼 주제를 알리는 계정의 Pub/Sub 알림 설정을 설정합니다.
계정에는 하나의 알림 설정 리소스만 있으며 Pub/Sub 주제는 1개만 설정할 수 있습니다.
|
BusinessCategories
이 API를 사용하면 Google에서 비즈니스 위치에 대해 지원되는 카테고리를 볼 수 있습니다. 사용 가능한 모든 비즈니스 카테고리의 페이지로 나눈 목록을 가져오거나 특정 검색어로 검색할 수 있습니다. 자세한 내용은 이 도움말의 카테고리 섹션을 참조하세요. https://support.google.com/business/answer/3038177
BatchGetBusinessCategories | |
---|---|
제공된 언어 및 GConcept ID에 대한 비즈니스 카테고리 목록을 반환합니다.
|
ListBusinessCategories | |
---|---|
비즈니스 카테고리의 목록을 반환합니다. 검색은 카테고리 이름과 일치하지만 카테고리 ID와는 일치하지 않습니다.
|
BusinessMessagingService
비즈니스가 비즈니스 메시지를 위해 위치를 등록하여 위치를 검색하는 소비자의 커뮤니케이션 채널을 활용할 수 있습니다. 위치의 비즈니스 메시지를 보고 작업을 실행하려면 위치의 MANAGER
또는 OWNER
여야 합니다.
팔로어
이 API는 팔로어의 관리 API를 노출합니다.
GetFollowersMetadata | |
---|---|
위치의 팔로어 설정을 가져옵니다. 계정 또는 위치가 존재하지 않는 경우 NOT_FOUND가 반환됩니다. 위치가 인증되지 않거나 지도에 연결되지 않은 경우 PRECONDITION_FAILED가 반환됩니다.
|
FoodMenuService
이 API를 사용하면 업체 위치의 음식 메뉴를 가져오고 업데이트할 수 있습니다.
Location.PriceList는 또한 유형 중 하나로 '메뉴'를 나타내지만 제한된 필드를 사용합니다. FoodMenus와 동일한 다운스트림 스토리지를 공유합니다. FoodMenuService로 이전이 완료되면 클라이언트는 예기치 않은 데이터 손실을 초래할 수 있으므로 메뉴 데이터를 업데이트하는 데 Location.PriceList를 더 이상 사용하지 않는 것이 좋습니다.
GetFoodMenus | |
---|---|
특정 위치의 음식 메뉴를 반환합니다. location.location_state.can_have_food_menu가 true인 경우에만 호출합니다.
|
UpdateFoodMenus | |
---|---|
특정 위치의 음식 메뉴를 업데이트합니다. location.location_state.can_have_food_menu가 true인 경우에만 호출합니다.
|
GoogleLocations
이 API를 사용하면 GoogleLocation
에 액세스하고 검색할 수 있습니다.
ListRecommendedGoogleLocations | |
---|---|
지정된 비즈니스 프로필 계정에 추천된 모든 개인 계정을 위한 추천은 사용자가 비즈니스 프로필에서 액세스할 수 있는 모든 위치 (위치 그룹을 통해 액세스할 수 있는 위치 포함)를 기반으로 하며 사용자를 위해 생성된 모든 추천의 상위 집합입니다.
|
ReportGoogleLocation | |
---|---|
|
SearchGoogleLocations | |
---|---|
지정된 요청과 일치하는 가능한 모든 위치를 검색합니다.
|
HealthProviderAttributesService
이 서비스를 사용하면 위치와 연결된 의료인 속성 (예: 위치에서 허용되는 보험)을 관리할 수 있습니다.
GetHealthProviderAttributes | |
---|---|
특정 위치의 의료인 속성을 반환합니다.
|
UpdateHealthProviderAttributes | |
---|---|
특정 위치의 의료인 속성을 업데이트합니다.
|
유용한 정보
Google 서비스에서 하나 이상의 비즈니스 정보에 대한 소비자 통계를 자세히 설명하는 보고서를 생성합니다. 기본 측정항목의 집계된 데이터는 최대 18개월의 기간에 걸쳐 쿼리할 수 있습니다. 분석을 지원하는 측정항목은 이 기간에 대해 집계된 데이터를 요일 또는 시간별로 세분화하여 표시할 수 있습니다. 운전 경로 요청을 선택한 기간 동안 스냅샷으로 보고할 수 있습니다.
ReportLocalPostInsights | |
---|---|
단일 비즈니스 정보에 연결된 지역 게시물 집합의 통계를 반환합니다. 어떤 측정항목과 보고 방식이 요청 프로토콜에 지정된 옵션입니다.
|
ReportLocationInsights | |
---|---|
위치별 측정항목 하나 이상의 통계가 포함된 보고서를 반환합니다.
|
InsuranceNetworkService
이 서비스를 사용하면 Google에서 의료 업체 위치에 대해 지원되는 모든 보험 네트워크를 가져올 수 있습니다.
ListInsuranceNetworks | |
---|---|
Google에서 지원하는 모든 보험 네트워크의 목록을 반환합니다.
|
LocalPosts
이 API는 지역 게시물의 관리 API를 노출합니다.
CreateLocalPost | |
---|---|
지정된 위치와 연결된 새 지역 게시물을 만들어 반환합니다.
|
DeleteLocalPost | |
---|---|
지역 게시물을 삭제합니다. 지역 게시물이 없으면
|
GetLocalPost | |
---|---|
지정된 지역 게시물을 가져옵니다. 지역 게시물이 없으면
|
ListLocalPosts | |
---|---|
위치와 연결된 지역 게시물 목록을 반환합니다.
|
UpdateLocalPost | |
---|---|
지정된 지역 게시물을 업데이트하고 업데이트된 지역 게시물을 반환합니다.
|
위치
이 API를 사용하면 Google에서 업체 위치를 관리할 수 있습니다. 이를 통해 Location
리소스를 관리할 수 있습니다. 이 클래스는 다음과 같은 리소스 모델을 정의합니다.
AssociateLocation | |
---|---|
위치를 장소 ID에 연결합니다. 이전 연결은 모두 덮어씁니다. 이 작업은 위치가 인증되지 않은 경우에만 유효합니다. 연결이 유효해야 합니다. 즉,
|
BatchGetLocations | |
---|---|
지정된 계정에서 지정된 모든 위치를 가져옵니다.
|
ClearLocationAssociation | |
---|---|
위치와 장소 ID 간의 연결을 삭제합니다. 이 작업은 위치가 인증되지 않은 경우에만 유효합니다.
|
CreateLocation | |
---|---|
지정된 계정이 소유한 새
|
DeleteLocation | |
---|---|
위치를 삭제합니다. |
FindMatchingLocations | |
---|---|
지정된 위치와 일치하는 가능한 모든 위치를 찾습니다. 이 작업은 위치가 인증되지 않은 경우에만 유효합니다.
|
GetChain | |
---|---|
지정된 체인을 가져옵니다. 체인이 없으면
|
GetGoogleUpdatedLocation | |
---|---|
지정된 위치의 Google 업데이트 버전을 가져옵니다. 위치가 없는 경우
|
GetLocation | |
---|---|
지정된 위치를 가져옵니다. 위치가 없는 경우
|
ListAttributeMetadata | |
---|---|
지정된 기본 카테고리 및 국가가 있는 위치에 사용할 수 있는 속성 목록을 반환합니다.
|
ListLocations | |
---|---|
지정된 계정의 위치를 나열합니다.
|
SearchChains | |
---|---|
체인 이름을 기준으로 체인을 검색합니다.
|
TransferLocation | |
---|---|
사용자가 소유한 계정에서 동일한 사용자가 관리하는 다른 계정으로 위치를 이동합니다. 사용자는 위치가 현재 연결된 계정의 소유자여야 하며, 대상 계정의 관리자 이상이어야 합니다. 위치를 새 리소스 이름으로 반환합니다.
|
UpdateLocation | |
---|---|
지정된 위치를 업데이트합니다. 사진은 Google+ 페이지가 있는 위치에만 허용됩니다. 위치가 없는 경우
|
미디어
이 서비스를 사용하면 위치에 연결된 미디어 (사진 및 동영상)를 관리할 수 있습니다.
CreateMediaItem | |
---|---|
위치에 대한 새 미디어 항목을 만듭니다.
|
DeleteMediaItem | |
---|---|
지정된 미디어 항목을 삭제합니다.
|
GetCustomerMediaItem | |
---|---|
요청된 고객 미디어 항목의 메타데이터를 반환합니다.
|
GetMediaItem | |
---|---|
요청된 미디어 항목의 메타데이터를 반환합니다.
|
ListCustomerMediaItems | |
---|---|
고객이 제공한 위치와 연결된 미디어 항목의 목록을 반환합니다.
|
ListMediaItems | |
---|---|
위치와 연결된 미디어 항목의 목록을 반환합니다.
|
StartUploadMediaItemData | |
---|---|
미디어 항목 업로드를 위한
|
UpdateMediaItem | |
---|---|
지정된 미디어 항목의 메타데이터를 업데이트합니다. 미디어 항목의 카테고리를 업데이트하는 데만 사용할 수 있습니다. 단, 새 카테고리는 COVER 또는 PROFILE일 수 없습니다.
|
QuestionsAndAnswers
이 서비스를 사용하여 위치에 대한 질문과 답변을 관리할 수 있습니다. 질문 및 답변 작업은 인증된 위치에서만 유효합니다.
CreateQuestion | |
---|---|
지정된 위치에 대한 질문을 추가합니다.
|
DeleteAnswer | |
---|---|
현재 사용자가 질문에 작성한 답변을 삭제합니다.
|
DeleteQuestion | |
---|---|
현재 사용자가 작성한 특정 질문을 삭제합니다.
|
ListAnswers | |
---|---|
지정된 질문에 대해 페이지로 나눈 답변 목록을 반환합니다.
|
ListQuestions | |
---|---|
지정된 위치에 대해 페이지로 나눈 질문 목록과 일부 답변을 반환합니다.
|
UpdateQuestion | |
---|---|
현재 사용자가 작성한 특정 질문을 업데이트합니다.
|
UpsertAnswer | |
---|---|
지정된 질문에 대해 답변을 만들거나 사용자가 작성한 기존 답변을 업데이트합니다. 사용자는 질문당 하나의 답변만 만들 수 있습니다.
|
리뷰
이 API는 리뷰에 대한 CRUD 작업을 제공합니다. google.mybusiness.v4.Reviews
.
BatchGetReviews | |
---|---|
지정된 모든 위치의 페이지로 나눈 리뷰 목록을 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.
|
DeleteReviewReply | |
---|---|
지정된 리뷰에 대한 답글을 삭제합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.
|
GetReview | |
---|---|
지정된 리뷰를 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다. 리뷰가 없거나 삭제된 경우
|
ListReviews | |
---|---|
지정된 위치의 페이지로 나눈 리뷰 목록을 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.
|
UpdateReviewReply | |
---|---|
지정된 리뷰에 대한 답글을 업데이트합니다. 답글이 없으면 답글이 생성됩니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.
|
ServiceLists
이 API를 사용하면 Google에서 업체 위치의 서비스 목록을 가져오고 업데이트할 수 있습니다. 서비스 목록에는 판매자가 제공하는 서비스 항목 목록이 포함됩니다. 이발, 온수기 설치 등의 서비스가 제공될 수 있습니다.
GetServiceList | |
---|---|
위치의 지정된 서비스 목록을 가져옵니다.
|
UpdateServiceList | |
---|---|
위치의 지정된 서비스 목록을 업데이트합니다.
|
인증
이 API를 사용하면 Google에서의 위치 인증을 관리할 수 있습니다. 이를 통해 Verification
리소스를 관리할 수 있습니다.
각 Location
에는 accounts/*/locations/*/verifications/*
라는 Verification
리소스 컬렉션이 있습니다.
CompleteVerification | |
---|---|
|
FetchVerificationOptions | |
---|---|
특정 언어로 된 위치에 대해 요건을 충족하는 모든 인증 옵션을 보고합니다.
|
ListVerifications | |
---|---|
위치 인증을 생성 시간순으로 나열합니다.
|
VerifyLocation | |
---|---|
위치 인증 절차를 시작합니다.
|
AcceptInvitationRequest
AccessControl.AcceptInvitation 요청 메시지입니다.
필드 | |
---|---|
name |
수락되는 초대의 이름입니다. |
계정
계정은 비즈니스 위치를 담는 컨테이너입니다. 비즈니스의 위치를 관리하는 유일한 사용자인 경우 개인 Google 계정을 사용할 수 있습니다. 여러 사용자와 공동으로 위치를 관리하려면 비즈니스 계정을 만드세요.
필드 | |
---|---|
name |
|
account_name |
계정의 이름입니다. |
type |
출력 전용. 이 계정의 |
role |
출력 전용. 호출자가 이 계정에 대해 보유한 |
state |
출력 전용. 이 계정의 |
account_number |
계정 참조 번호(프로비저닝된 경우) |
permission_level |
출력 전용. 호출자가 이 계정에 대해 보유한 |
organization_info |
조직의 추가 정보입니다. 조직 계정의 경우에만 채워집니다. |
OrganizationInfo
조직에 대해 저장된 추가 정보입니다.
필드 | |
---|---|
registered_domain |
계정에 등록된 도메인입니다. |
postal_address |
계정의 우편 주소입니다. |
phone_number |
조직의 연락처 번호입니다. |
AccountRole
인증된 사용자가 이 계정에 대해 갖는 액세스 수준을 나타냅니다. 자세한 내용은 고객센터 도움말을 참고하세요.
열거형 | |
---|---|
ACCOUNT_ROLE_UNSPECIFIED |
지정되지 않음 |
OWNER |
사용자가 이 계정을 소유합니다. (UI에는 '기본 소유자'로 표시됩니다.) |
CO_OWNER |
사용자가 계정의 공동 소유자입니다. (UI에 '소유자'로 표시됨) |
MANAGER |
사용자가 이 계정을 관리할 수 있습니다. |
COMMUNITY_MANAGER |
사용자는 계정의 소셜 (Google+) 페이지를 관리할 수 있습니다. (UI에는 '사이트 관리자'로 표시됨) |
AccountState
Google에서 계정을 인증했는지 여부 등 계정의 상태를 나타냅니다.
필드 | |
---|---|
status |
인증을 받으면 향후 만들어지는 위치는 자동으로 Google 지도에 연결되고, 검토 없이도 Google+ 페이지가 생성됩니다. |
AccountStatus
계정의 확인 상태를 나타냅니다.
열거형 | |
---|---|
ACCOUNT_STATUS_UNSPECIFIED |
지정되지 않음 |
VERIFIED |
인증된 계정입니다. |
UNVERIFIED |
계정이 인증되지 않았으며, 인증이 요청되지 않았습니다. |
VERIFICATION_REQUESTED |
인증이 요청되었으나 인증이 필요한 계정입니다. |
AccountType
계정의 종류를 나타냅니다(개인/사용자 계정 또는 비즈니스 계정).
열거형 | |
---|---|
ACCOUNT_TYPE_UNSPECIFIED |
지정되지 않음 |
PERSONAL |
최종 사용자 계정. |
LOCATION_GROUP |
위치 그룹입니다. 자세한 내용은 고객센터 도움말을 참고하세요. |
USER_GROUP |
그룹으로 조직 직원을 분리하는 사용자 그룹 자세한 내용은 고객센터 도움말을 참고하세요. |
ORGANIZATION |
회사를 대표하는 조직입니다. 자세한 내용은 고객센터 도움말을 참고하세요. |
AdWordsLocationExtensions
애드워즈에 표시되는 추가 정보입니다.
필드 | |
---|---|
ad_phone |
위치의 기본 전화번호 대신 애드워즈 위치 광고 확장에 표시되는 대체 전화번호입니다. |
AddressInput
ADDRESS 확인을 위한 입력입니다.
필드 | |
---|---|
mailer_contact_name |
메일을 받을 연락처 이름입니다. |
관리
필드 | |
---|---|
name |
리소스 이름입니다. 계정 관리자의 경우 위치 관리자의 경우 |
admin_name |
관리자의 이름입니다. 처음 초대할 때 이 주소는 초대 대상자의 이메일 주소입니다. |
role |
이 관리자가 지정된 |
pending_invitation |
출력 전용. 지정된 리소스에 대해 대기 중인 초대가 이 관리자에게 있는지 여부를 나타냅니다. |
AdminRole
관리자의 액세스 수준을 나타냅니다. 자세한 내용은 고객센터 도움말을 참고하세요.
열거형 | |
---|---|
ADMIN_ROLE_UNSPECIFIED |
지정되지 않음 |
OWNER |
관리자가 소유자 수준의 액세스 권한을 가지며 기본 소유자입니다. (UI에는 '기본 소유자'로 표시됩니다.) |
CO_OWNER |
관리자에게 소유자 수준의 액세스 권한이 있습니다. (UI에 '소유자'로 표시됨) |
MANAGER |
관리자에게 관리 액세스 권한이 있습니다. |
COMMUNITY_MANAGER |
관리자가 소셜 (Google+) 페이지를 관리할 수 있습니다. (UI에는 '사이트 관리자'로 표시됨) |
AlertType
알림 게시물이 생성된 이벤트의 유형입니다.
열거형 | |
---|---|
ALERT_TYPE_UNSPECIFIED |
알림이 지정되지 않았습니다. |
COVID_19 |
2019 코로나바이러스 유행성 전염병과 관련된 알림입니다. 코로나19 게시물은 요약 필드와 클릭 유도 문구 필드만 지원합니다. 이러한 알림이 더 이상 관련이 없는 경우 코로나19 유형에 대한 새 알림 게시물 생성이 사용 중지됩니다. 하지만 판매자는 기존의 코로나19 게시물을 계속 관리할 수 있습니다. |
알레르기 유발 물질
식품과 관련된 알레르기 유발 물질 정보입니다.
열거형 | |
---|---|
ALLERGEN_UNSPECIFIED |
알레르기 유발 물질 미지정 |
DAIRY |
유제품 관련 알레르기 유발 물질 |
EGG |
달걀 관련 알레르기 유발 물질 |
FISH |
물고기 관련 알레르기 유발 물질 |
PEANUT |
땅콩 관련 알레르기 유발 물질 |
SHELLFISH |
조개 관련 알레르기 유발 물질 |
SOY |
콩 관련 알레르기 유발 물질 |
TREE_NUT |
견과류 관련 알레르기 유발 물질 |
WHEAT |
밀 관련 알레르기 유발 물질 |
정답
질문에 대한 답변을 나타냅니다.
필드 | |
---|---|
name |
출력 전용. 답변 accounts/*/locations/*/questions/*/answers/*의 고유한 이름입니다. |
author |
출력 전용. 답변 작성자입니다. |
upvote_count |
출력 전용. 답변에 대한 찬성 투표 수입니다. |
text |
답변의 텍스트입니다. 공백이 아닌 문자를 하나 이상 포함해야 합니다. 최대 길이는 4,096자(영문 기준)입니다. |
create_time |
출력 전용. 답변이 작성된 시간의 타임스탬프입니다. |
update_time |
출력 전용. 답변이 마지막으로 수정된 시간의 타임스탬프입니다. |
AssociateLocationRequest
Locations.AssociateLocationRequest 요청 메시지입니다.
필드 | |
---|---|
name |
연결할 위치의 리소스 이름입니다. |
place_id |
설정할 연결입니다. 설정되지 않은 경우 일치하는 항목이 없음을 나타냅니다. |
속성
위치 속성입니다. 속성은 위치에 대한 추가 정보를 제공합니다. 위치에 설정할 수 있는 속성은 해당 위치의 속성 (예: 카테고리)에 따라 다를 수 있습니다. 사용 가능한 속성은 Google에서 결정하며 API 변경 없이 추가 및 삭제될 수 있습니다.
필드 | |
---|---|
attribute_id |
속성의 ID입니다. 속성 ID는 Google에서 제공합니다. |
value_type |
출력 전용. 이 속성에 포함된 값의 유형입니다. 값을 해석하는 방법을 결정하는 데 사용해야 합니다. |
values[] |
이 속성의 값입니다. 제공된 값의 유형은 해당 속성에 예상되는 유형과 일치해야 합니다. AttributeValueType을 참고하세요. 여러 속성 값을 제공할 수 있는 반복되는 입력란입니다. 속성 유형은 하나의 값만 지원합니다. |
repeated_enum_value |
속성 값 유형이 REPEATED_ENUM인 경우 이 속성에 속성 값이 포함되고 다른 값 필드는 비어 있어야 합니다. |
url_values[] |
속성 값 유형이 URL인 경우 이 입력란에는 이 속성의 값이 포함되며 다른 값 입력란은 비어 있어야 합니다. |
AttributeMetadata
속성의 메타데이터입니다. 현지화된 이름과 관련 속성을 함께 그룹화하기 위한 제목을 비롯하여 속성의 표시 정보가 포함됩니다.
필드 | |
---|---|
attribute_id |
속성의 ID입니다. |
value_type |
속성의 값 유형입니다. 설정 및 검색된 값은 이 유형이어야 합니다. |
display_name |
사용할 수 있는 경우 속성의 현지화된 표시 이름입니다. 그렇지 않은 경우 영어 표시 이름입니다. |
group_display_name |
사용할 수 있는 경우 이 속성을 포함하는 그룹의 현지화된 표시 이름이고, 그렇지 않은 경우 영어 그룹 이름입니다. 관련 속성은 그룹으로 수집되며 여기에 제공된 제목 아래 함께 표시되어야 합니다. |
is_repeatable |
true인 경우 속성이 여러 값을 지원합니다. false인 경우 하나의 값만 제공해야 합니다. |
value_metadata[] |
일부 속성 유형 (예: enum)의 경우 지원되는 값 목록과 이러한 값에 해당하는 표시 이름이 제공됩니다. |
is_deprecated |
true인 경우 속성은 지원 중단되었으며 더 이상 사용하면 안 됩니다. 지원 중단된 경우 이 속성을 업데이트해도 오류가 발생하지는 않지만 업데이트가 저장되지 않습니다. 지원 중단되면 어느 시점이 되면 속성이 완전히 삭제되고 오류가 됩니다. |
AttributeValueMetadata
지원되는 속성 값의 메타데이터입니다.
필드 | |
---|---|
value |
속성 값입니다. |
display_name |
이 값의 표시 이름으로, 가능한 경우 현지화되고 그렇지 않은 경우 영어입니다. 값 표시 이름은 속성 표시 이름과 함께 컨텍스트에서 사용하기 위한 것입니다. 예를 들어 'Wi-Fi' 열거형 속성의 경우 유료 Wi-Fi를 나타내는 'paid'가 포함될 수 있습니다. |
AttributeValueType
속성의 값 유형입니다.
열거형 | |
---|---|
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED |
지정되지 않음 |
BOOL |
이 속성의 값은 부울 값입니다. |
ENUM |
이 속성에는 사용할 수 있는 사용 가능한 값의 사전 결정된 목록이 있습니다. 이 속성의 메타데이터는 이러한 값을 나열합니다. |
URL |
이 속성의 값은 URL입니다. |
REPEATED_ENUM |
속성 값은 명시적으로 설정하거나 설정 해제할 수 있는 여러 값이 가능한 열거형입니다. |
작성자
질문 또는 답변의 작성자를 나타냅니다.
필드 | |
---|---|
display_name |
사용자의 표시 이름 |
profile_photo_url |
사용자의 프로필 사진 URL입니다. |
type |
작성자가 속하는 사용자 유형입니다. |
AuthorType
작성자가 속하는 사용자 유형의 열거형입니다.
열거형 | |
---|---|
AUTHOR_TYPE_UNSPECIFIED |
사용해서는 안 됩니다. |
REGULAR_USER |
일반 사용자입니다. |
LOCAL_GUIDE |
지역 가이드 |
MERCHANT |
위치의 소유자/관리자 |
BasicMetricsRequest
기본 측정항목 통계 요청입니다.
필드 | |
---|---|
metric_requests[] |
데이터 반환 방법에 대한 옵션을 포함하여 값을 반환하는 측정항목의 모음입니다. |
time_range |
측정항목을 수집할 범위입니다. 최대 기간은 요청일로부터 18개월입니다. 요청 날짜와 가까운 날짜에 데이터가 누락되는 경우도 있습니다. 누락된 데이터는 응답의 |
BatchGetBusinessCategoriesRequest
BusinessCategories.BatchGetBusinessCategories 요청 메시지입니다.
필드 | |
---|---|
language_code |
필수 항목입니다. 카테고리 이름이 반환되어야 하는 BCP 47 언어 코드입니다. |
category_ids[] |
필수 항목입니다. 이름을 하나 이상 설정해야 합니다. 현지화된 카테고리 이름이 반환되어야 하는 GConcept ID입니다. |
region_code |
선택사항입니다. 비표준 언어를 유추하는 데 사용되는 ISO 3166-1 alpha-2 국가 코드입니다. |
view |
필수 항목입니다. 카테고리 리소스에 대해 응답으로 반환해야 하는 부분을 지정합니다. |
BatchGetBusinessCategoriesResponse
BusinessCategories.BatchGetBusinessCategories의 응답 메시지입니다.
필드 | |
---|---|
categories[] |
요청에 제공된 GConcept ID와 일치하는 카테고리입니다. 요청에 있는 카테고리 ID와 동일한 순서로 나오지는 않습니다. |
BatchGetLocationsRequest
Locations.BatchGetLocations 요청 메시지입니다.
필드 | |
---|---|
name |
위치를 가져올 계정의 이름입니다. |
location_names[] |
가져올 위치의 모음으로, 이름으로 지정됩니다. |
BatchGetLocationsResponse
Locations.BatchGetLocations의 응답 메시지입니다.
필드 | |
---|---|
locations[] |
위치의 모음입니다. |
BatchGetReviewsRequest
Reviews.BatchGetReviews 요청 메시지입니다.
필드 | |
---|---|
name |
여러 위치에 대한 리뷰 목록을 가져올 계정의 이름입니다. |
location_names[] |
리뷰를 가져올 위치의 모음이며 이름으로 지정됩니다. |
page_size |
페이지당 가져올 리뷰 수입니다. 기본값은 50개입니다. |
page_token |
지정하면 다음 리뷰 페이지를 가져옵니다. |
order_by |
선택사항입니다. 리뷰 정렬의 기준이 될 필드를 지정합니다. 지정하지 않으면 반환되는 리뷰 순서가 기본적으로 |
ignore_rating_only_reviews |
평가 전용 리뷰를 무시할지 여부입니다. |
BatchGetReviewsResponse
Reviews.BatchGetReviews의 응답 메시지입니다.
필드 | |
---|---|
location_reviews[] |
위치 정보가 포함된 리뷰입니다. |
next_page_token |
리뷰 수가 요청된 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 리뷰 페이지를 가져오는 토큰으로 채워집니다. 리뷰가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다. |
BusinessHours
이 위치의 영업시간을 나타냅니다. TimePeriod
인스턴스 컬렉션을 보유합니다.
필드 | |
---|---|
periods[] |
이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다. |
CallToAction
사용자가 게시물을 클릭할 때 수행되는 동작입니다.
필드 | |
---|---|
action_type |
수행될 동작 유형입니다. |
url |
클릭 시 사용자가 연결되는 URL입니다. 통화 CTA에서는 이 필드를 설정되지 않은 상태로 두어야 합니다. |
ActionType
수행될 동작 유형입니다.
열거형 | |
---|---|
ACTION_TYPE_UNSPECIFIED |
유형이 지정되지 않습니다. |
BOOK |
사용자가 약속/테이블 등을 예약하도록 유도하는 게시물입니다. |
ORDER |
사용자의 주문을 유도하는 게시물입니다. |
SHOP |
사용자가 제품 카탈로그를 둘러보도록 유도하는 게시물입니다. |
LEARN_MORE |
사용자가 웹사이트에서 자세한 내용을 확인하도록 유도하는 게시물입니다. |
SIGN_UP |
사용자의 등록/가입/참여를 유도하는 게시물입니다. |
GET_OFFER |
지원이 중단되었습니다. |
CALL |
사용자가 비즈니스에 전화하도록 유도하는 게시물입니다. |
카테고리
이 비즈니스의 업무 내용이 아니라 업종을 설명하는 카테고리입니다. 유효한 카테고리 ID 목록과 사람이 읽을 수 있는 이름에 대한 매핑은 categories.list를 참조하세요.
필드 | |
---|---|
display_name |
. 사람이 읽을 수 있는 카테고리 이름입니다. 위치를 읽을 때 설정됩니다. 위치를 수정할 때는 참고: 이 필드는 응답에만 사용됩니다. 요청에서 여기에 지정된 값은 무시됩니다. |
category_id |
. 이 카테고리의 안정적인 ID입니다 (Google에서 제공). 카테고리를 수정할 때 (위치를 만들거나 업데이트할 때) 참고: 이 필드는 응답에만 사용됩니다. 요청에서 여기에 지정된 값은 무시됩니다. |
service_types[] |
. 이 비즈니스 카테고리에서 사용할 수 있는 모든 서비스 유형의 목록입니다. 참고: 이 필드는 응답에만 사용됩니다. 요청에서 여기에 지정된 값은 무시됩니다. |
more_hours_types[] |
출력 전용. 이 비즈니스 카테고리에 사용할 수 있는 기타 영업시간 유형입니다. |
CategoryView
서버에서 반환하는 데이터의 양을 제한하는 데 도움이 되는 enum입니다.
열거형 | |
---|---|
CATEGORY_VIEW_UNSPECIFIED |
지정되지 않으며 CATEGORY_METADATA_ONLY와 같습니다. |
BASIC |
서버 응답에는 카테고리 필드 display_name, category_id, language_code만 포함됩니다. 서비스 유형 메타데이터 관련 필드가 생략됩니다. |
FULL |
응답의 모든 필드를 반환합니다. |
체인
체인은 비즈니스 위치와 제휴할 수 있는 브랜드입니다.
필드 | |
---|---|
name |
|
chain_names[] |
체인의 이름입니다. |
websites[] |
체인의 웹사이트입니다. |
location_count |
이 체인에 속한 위치의 수입니다. |
ChainName
체인을 표시할 때 사용할 이름입니다.
필드 | |
---|---|
display_name |
이 체인의 표시 이름입니다. |
language_code |
이름의 언어로 된 BCP 47 코드입니다. |
ChainUrl
체인을 표시할 때 사용되는 URL입니다.
필드 | |
---|---|
url |
체인의 URL입니다. |
ClearLocationAssociationRequest
Locations.ClearLocationAssociationRequest의 요청 메시지입니다.
필드 | |
---|---|
name |
연결 해제할 위치의 리소스 이름입니다. |
CompleteVerificationRequest
Verifications.CompleteVerificationAction 요청 메시지입니다.
필드 | |
---|---|
name |
완료할 인증의 리소스 이름입니다. |
pin |
인증을 완료하기 위해 판매자가 받은 PIN 코드입니다. |
CompleteVerificationResponse
Verifications.CompleteVerificationAction의 응답 메시지입니다.
필드 | |
---|---|
verification |
완료된 인증 |
CreateAccountAdminRequest
AccessControl.CreateAccountAdmin 요청 메시지입니다.
필드 | |
---|---|
parent |
이 관리자가 생성된 계정의 리소스 이름입니다. |
admin |
생성할 관리자입니다. |
CreateAccountRequest
Accounts.CreateAccount에 대한 요청 메시지입니다.
필드 | |
---|---|
primary_owner |
생성 중인 계정의 기본 소유자가 될 계정의 리소스 이름입니다. |
account |
생성할 계정의 계정 정보입니다. 계정 이름 및 유형 필드만 허용됩니다. |
CreateLocalPostRequest
CreateLocalPost 요청 메시지입니다.
필드 | |
---|---|
parent |
이 지역 게시물을 생성할 위치의 이름입니다. |
local_post |
새 지역 게시물 메타데이터입니다. |
CreateLocationAdminRequest
AccessControl.CreateLocationAdmin 요청 메시지입니다.
필드 | |
---|---|
parent |
이 관리자가 생성된 위치의 리소스 이름입니다. |
admin |
생성할 관리자입니다. |
CreateLocationRequest
Locations.CreateLocation 요청 메시지입니다.
필드 | |
---|---|
parent |
이 위치를 만들 계정의 이름입니다. |
location |
새 위치 메타데이터입니다. |
validate_only |
true인 경우 실제로 위치를 생성하지 않고 요청의 유효성이 검사됩니다. |
request_id |
서버에서 중복 요청을 감지하는 고유한 요청 ID입니다. UUID를 사용하는 것이 좋습니다. 최대 길이는 50자(영문 기준)입니다. |
CreateMediaItemRequest
Media.CreateMediaItem 요청 메시지입니다.
필드 | |
---|---|
parent |
이 미디어 항목이 생성될 위치의 리소스 이름입니다. |
media_item |
생성될 미디어 항목입니다. |
CreateQuestionRequest
QuestionsAndAnswers.CreateQuestion 요청 메시지입니다.
필드 | |
---|---|
parent |
질문을 작성할 위치의 이름입니다. |
question |
새로운 질문 |
DeclineInvitationRequest
AccessControl.DeclineInvitation 요청 메시지입니다.
필드 | |
---|---|
name |
거부된 계정 초대의 이름입니다. |
DeleteAccountAdminRequest
AccessControl.DeleteAccountAdmin 요청 메시지입니다.
필드 | |
---|---|
name |
계정에서 삭제할 관리자의 리소스 이름입니다. |
DeleteAnswerRequest
QuestionsAndAnswers.DeleteAnswer 요청 메시지입니다.
필드 | |
---|---|
parent |
답변을 삭제할 질문의 이름입니다. |
DeleteLocalPostRequest
DeleteLocalPost 요청 메시지입니다.
필드 | |
---|---|
name |
삭제할 지역 게시물의 이름입니다. |
DeleteLocationAdminRequest
AccessControl.DeleteLocationAdmin 요청 메시지입니다.
필드 | |
---|---|
name |
위치에서 삭제할 관리자의 리소스 이름입니다. |
DeleteLocationRequest
Locations.DeleteLocation 요청 메시지입니다.
필드 | |
---|---|
name |
삭제할 위치의 이름입니다. |
DeleteMediaItemRequest
Media.DeleteMediaItem 요청 메시지입니다.
필드 | |
---|---|
name |
삭제할 미디어 항목의 이름입니다. |
DeleteNotificationsRequest
Accounts.DeleteNotifications 요청 메시지입니다.
필드 | |
---|---|
name |
삭제할 알림 설정의 리소스 이름입니다. |
DeleteQuestionRequest
QuestionsAndAnswers.DeleteQuestion 요청 메시지입니다.
필드 | |
---|---|
name |
삭제할 질문의 이름입니다. |
DeleteReviewReplyRequest
Reviews.DeleteReviewReply 요청 메시지입니다.
필드 | |
---|---|
name |
삭제할 리뷰 답글의 이름입니다. |
DietaryRestriction
식품의 식이 정보입니다.
열거형 | |
---|---|
DIETARY_RESTRICTION_UNSPECIFIED |
식이 유형 미지정 |
HALAL |
음식을 할랄 음식으로 표현 |
KOSHER |
음식을 코셔 요리로 표현 |
ORGANIC |
유기농 음식으로 표현된 음식 |
VEGAN |
비건 음식으로 표현한 음식입니다. |
VEGETARIAN |
음식을 채식 요리로 표현 |
DimensionalMetricValue
특정 시간 측정기준을 가진 단일 측정항목의 값입니다.
필드 | |
---|---|
metric_option |
이 측정기준 값을 요청한 옵션입니다. |
time_dimension |
값의 측정기준입니다. |
value |
값입니다. 값이 설정되지 않으면 요청된 데이터가 누락됩니다. |
TimeDimension
데이터를 나누는 측정기준입니다.
필드 | |
---|---|
day_of_week |
이 값에 해당하는 요일 ('MONDAY'부터 'SUNDAY'까지)입니다. BREAKDOWN_DAY_OF_WEEK 옵션에 설정합니다. |
time_of_day |
이 값에 해당하는 시간 (0~23)입니다. BREAKDOWN_HOUR_OF_DAY 옵션에 대해 설정되었습니다. |
time_range |
이 값이 포함되는 시간 범위입니다. AGGREGATED_TOTAL 및 AGGREGATED_DAILY 옵션에 대해 설정합니다. |
DrivingDirectionMetricsRequest
운전 경로 통계 요청입니다.
필드 | |
---|---|
num_days |
데이터를 집계할 일수입니다. 반환된 결과는 요청된 마지막 일수 동안의 데이터를 사용할 수 있습니다. 유효한 값은 7, 30, 90입니다. |
language_code |
언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다. |
NumDays
이 요청이 지원할 수 있는 일수입니다.
열거형 | |
---|---|
SEVEN |
7일. 기본값입니다. |
THIRTY |
30일 |
NINETY |
90일 |
EmailInput
이메일 확인을 위한 입력입니다.
필드 | |
---|---|
email_address |
PIN을 받을 이메일 주소입니다. 이메일 주소는 FetchVerificationOptions에서 제공한 주소 중 하나인 경우에만 허용됩니다. |
ErrorDetail
유효성 검사 또는 내부 실패를 초래한 오류에 대한 세부정보입니다.
필드 | |
---|---|
code |
상태 코드로, |
field |
요청 본문의 필드로 연결되는 경로입니다. 값은 프로토콜 버퍼 필드를 식별하는 점으로 구분된 식별자 시퀀스입니다. 예를 들어 'error_details.field'는 이 필드를 식별합니다. |
message |
필드로 인한 실패 발생 이유에 대한 설명입니다. 메시지는 영어로 작성되어 사용자에게 표시하기에 적합하지 않을 수 있습니다. |
value |
요청에 실패한 값입니다. |
field_index |
이 오류를 생성한 요청 필드가 반복되면 유효성 검사 실패를 야기한 해당 필드의 항목 색인(0 기반)이 포함됩니다. |
ErrorCode
ErrorDetail
에 대한 오류 코드:
- 1~199: 모든 필드에 적용되는 일반적인 오류 코드입니다.
- 1000~1099: 사진 관련 오류 코드입니다.
- 1100~1199: 주소 및 위도/경도 관련 오류 코드
- 1200~1299: 카테고리 관련 오류 코드입니다.
- 1300~1399: 작업 관련 오류 코드입니다.
열거형 | |
---|---|
ERROR_CODE_UNSPECIFIED |
포괄적 오류 코드입니다. |
MISSING_VALUE |
필수 입력란입니다. |
INVALID_VALUE |
입력한 값이 잘못되었습니다. |
INVALID_CHARACTERS |
잘못된 문자가 있습니다. |
TOO_MANY_ITEMS |
최대 항목 수보다 많은 항목이 반복되는 입력란에 입력되었습니다. |
READ_ONLY |
읽기 전용 필드는 수정할 수 없습니다. |
OVERLAPPING_RANGES |
반복되는 필드에 있는 항목은 서로 겹치는 범위입니다. |
INVERTED_RANGE |
제공된 범위가 반전되었습니다. 범위가 비어 있는 경우도 포함됩니다. |
VALUE_OUTSIDE_ALLOWED_RANGE |
입력한 값이 허용되는 범위를 벗어납니다. |
MISSING_DEPENDENT_FIELD |
필수 종속 입력란이 없습니다. |
FIELD_HAS_DEPENDENCIES |
종속 입력란에 필요한 필드이므로 삭제할 수 없습니다. |
UNSUPPORTED_VALUE |
제공된 값은 유효할 수도 있지만 다른 제약조건으로 인해 지원되지 않습니다. |
EXPIRED_VALUE |
제공된 값이 만료되어 더 이상 유효하지 않습니다. |
PHOTO_FETCH_FAILED |
지정된 URL에서 사진을 가져오지 못했습니다. |
PHOTO_UPLOAD_FAILED |
지정된 URL에서 사진을 업로드하지 못했습니다. |
GEOCODE_ERROR |
위도/경도를 자동으로 결정하는 중에 오류가 발생했습니다. |
LAT_LNG_OUTSIDE_COUNTRY |
제공된 위도/경도가 제공된 국가에 해당하지 않습니다. |
LAT_LNG_REQUIRED |
위도와 경도를 입력해야 합니다. |
LAT_LNG_TOO_FAR_FROM_ADDRESS |
위도/경도 및 주소 쌍이 너무 멀리 떨어져 있습니다. |
CATEGORY_NOT_VERIFIED |
제공된 카테고리가 확인되지 않았습니다. |
OPERATION_EXECUTION_ERROR |
일반 작업 실행 오류입니다. |
OPERATION_UNSUPPORTED_UNDER_ACCOUNT_CONDITION |
계정 상태로 인해 지원되지 않는 작업입니다. |
LOCATION_DISABLED_FOR_LOCAL_POST_API |
Local Post API에서 위치가 사용 중지되었습니다. |
FetchVerificationOptionsRequest
Verifications.FetchVerificationOptions 요청 메시지입니다.
필드 | |
---|---|
name |
확인할 위치의 리소스 이름입니다. |
language_code |
인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다. 사용 가능한 옵션은 언어에 따라 다릅니다. |
context |
서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에 필수입니다. 다른 비즈니스 유형의 위치에 설정된 경우 INVALID_이(가) 발생합니다. |
FetchVerificationOptionsResponse
Verifications.FetchVerificationOptions의 응답 메시지입니다.
필드 | |
---|---|
options[] |
사용 가능한 인증 옵션입니다. |
FindMatchingLocationsRequest
Locations.FindMatchingLocations 요청 메시지입니다.
필드 | |
---|---|
name |
일치하는 항목을 찾을 위치의 리소스 이름입니다. |
language_code |
일치하는 위치의 기본 언어입니다 (BCP-47 형식). |
num_results |
반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청하면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기 기능이 없습니다. |
max_cache_duration |
지원이 중단되었습니다. 이 필드는 모든 요청에서 무시됩니다. |
FindMatchingLocationsResponse
Locations.FindMatchingLocations의 응답 메시지입니다.
필드 | |
---|---|
matched_locations[] |
지정된 위치와 일치할 가능성이 있는 위치의 모음으로, 가장 일치하는 항목에서 가장 낮은 위치 순서로 나열됩니다. 정확히 일치하는 항목이 있으면 첫 번째 위치에 배치됩니다. |
match_time |
이 위치의 일치 알고리즘이 마지막으로 실행된 시간입니다. |
FollowersMetadata
위치의 팔로어 메타데이터입니다.
필드 | |
---|---|
name |
리소스 이름입니다. accounts/{account_id}/locations/{location_id}/followers/metadata |
count |
위치의 총 팔로어 수입니다. |
FoodMenu
음식 요리를 제공하는 비즈니스의 메뉴입니다.
필드 | |
---|---|
labels[] |
필수 항목입니다. 언어 태그가 지정된 메뉴 라벨입니다. 예: '메뉴', '점심 특별 메뉴' 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
source_url |
선택사항입니다. 이동할 웹페이지가 있는 경우 메뉴의 소스 URL입니다. |
sections[] |
필수 항목입니다. 메뉴의 섹션. |
cuisines[] |
선택사항입니다. 음식 메뉴의 요리 정보입니다. 이 입력란을 제공하는 것이 좋습니다. |
요리
식당의 요리 정보입니다.
열거형 | |
---|---|
CUISINE_UNSPECIFIED |
요리 미지정 |
AMERICAN |
미국 음식 |
ASIAN |
아시아 요리 |
BRAZILIAN |
브라질 요리 |
BREAK_FAST |
아침 식사 |
BRUNCH |
브런치 |
CHICKEN |
닭 |
CHINESE |
중국 음식 |
FAMILY |
가족 스타일 요리 |
FAST_FOOD |
패스트푸드 |
FRENCH |
프랑스 음식 |
GREEK |
그리스 요리 |
GERMAN |
독일 요리 |
HAMBURGER |
햄버거 |
INDIAN |
인도 음식 |
INDONESIAN |
인도네시아 요리 |
ITALIAN |
이탈리아 음식 |
JAPANESE |
일본 음식 |
KOREAN |
한국 음식 |
LATIN_AMERICAN |
남미 음식 |
MEDITERRANEAN |
지중해 요리 |
MEXICAN |
멕시코 음식 |
PAKISTANI |
파키스탄 요리 |
PIZZA |
피자 |
SEAFOOD |
해산물 요리 |
SPANISH |
스페인 요리 |
SUSHI |
초밥 |
THAI |
태국 요리 |
TURKISH |
터키 요리 |
VEGETARIAN |
채식주의자 음식 |
VIETNAMESE |
베트남 요리 |
OTHER_CUISINE |
기타 요리 |
FoodMenuItem
섹션의 항목입니다. 요리 자체일 수도 있고, FoodMenuItemOption을 여러 개 포함할 수도 있습니다.
필드 | |
---|---|
labels[] |
필수 항목입니다. 이 메뉴 항목의 언어 태그 라벨입니다. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
attributes |
필수 항목입니다. 상품의 세부 속성입니다. 항목 옵션이 지정되면 이 속성이 기본 속성으로 간주되어 각 옵션에 채워집니다. |
options[] |
선택사항입니다. 이는 여러 가지 옵션이 제공되는 상품에 관한 것이며 사용자가 직접 선택해야 합니다. 예: '일반' 또는 '라지' 피자 옵션을 지정하면 항목 수준의 라벨과 속성이 자동으로 첫 번째 옵션의 라벨 및 속성이 됩니다. 클라이언트는 이 입력란에 다른 추가 음식 옵션만 지정하면 됩니다. |
FoodMenuItemAttributes
식품/요리의 속성입니다.
필드 | |
---|---|
price |
필수 항목입니다. 음식의 가격입니다. |
spiciness |
선택사항입니다. 음식의 매운 정도입니다. |
allergen[] |
선택사항입니다. 음식과 관련된 알레르기 유발 물질입니다. 이 입력란을 제공하는 것이 좋습니다. |
dietary_restriction[] |
선택사항입니다. 음식의 식이 정보입니다. 이 입력란을 제공하는 것이 좋습니다. |
nutrition_facts |
선택사항입니다. 음식 옵션의 영양 성분입니다. 이 입력란을 제공하는 것이 좋습니다. |
ingredients[] |
선택사항입니다. 음식 요리 옵션의 재료입니다. |
serves_num_people |
선택사항입니다. 이 음식 옵션으로 주문 가능한 인원수입니다. |
preparation_methods[] |
선택사항입니다. 음식 요리 옵션을 준비하는 방법입니다. |
portion_size |
선택사항입니다. 주문 규모(상품 단위로 표시됨) (예: '꼬챙이' 4개, '조각' 6개') |
media_keys[] |
선택사항입니다. 요리와 연결된 미디어의 미디어 키입니다. 사진 미디어만 지원됩니다. 연결된 사진이 여러 개인 경우 첫 번째 사진이 기본 사진으로 간주됩니다. |
재료
이 메시지는 음식의 재료 정보를 나타냅니다.
필드 | |
---|---|
labels[] |
필수 항목입니다. 재료를 설명하는 라벨입니다. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
PortionSize
한 조각씩 서빙하는 음식의 분량입니다.
필드 | |
---|---|
quantity |
필수 항목입니다. 부분 수입니다. |
unit[] |
필수 항목입니다. 반복되는 name_info 필드는 여러 언어로 된 단위에 사용됩니다. |
FoodMenuItemOption
항목의 옵션입니다. 사용자를 명시적으로 선택해야 합니다.
필드 | |
---|---|
labels[] |
필수 항목입니다. 이 메뉴 항목 옵션의 언어 태그 라벨입니다. E.g.: 'beef pad thai', 'veggie pad thai', 'small pizza', 'large pizza'. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
attributes |
필수 항목입니다. 상품 옵션의 세부 속성입니다. 지정되지 않은 개별 속성은 상품 수준 속성을 기반으로 상속됩니다. |
FoodMenuSection
메뉴의 섹션입니다. 여러 항목/요리를 포함할 수 있습니다.
필드 | |
---|---|
labels[] |
필수 항목입니다. 이 메뉴 섹션의 언어 태그 라벨입니다. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
items[] |
필수 항목입니다. 섹션의 항목입니다. 각 섹션에는 항목이 1개 이상 있어야 합니다. |
FoodMenus
음식 요리를 제공하는 비즈니스의 메뉴입니다.
필드 | |
---|---|
name |
필수 항목입니다. 이 위치의 Google 식별자(형식: |
menus[] |
선택사항입니다. 음식 메뉴의 컬렉션입니다. |
GenerateAccountNumberRequest
Accounts.GenerateAccountNumber 요청 메시지입니다.
필드 | |
---|---|
name |
계좌 번호를 생성할 계정의 이름입니다. |
GetAccountRequest
Accounts.GetAccount에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
가져올 계정의 이름입니다. |
GetChainRequest
Locations.GetChain 요청 메시지입니다.
필드 | |
---|---|
name |
|
GetCustomerMediaItemRequest
Media.GetCustomerMediaItem 요청 메시지입니다.
필드 | |
---|---|
name |
요청된 고객 미디어 항목의 리소스 이름입니다. |
GetFollowersMetadataRequest
위치의 팔로어 메타데이터를 가져오는 요청 메시지입니다.
필드 | |
---|---|
name |
위치의 팔로어 메타데이터의 리소스 이름입니다. accounts/{account_id}/locations/{location_id}/followers/metadata |
GetFoodMenusRequest
FoodMenu.GetFoodMenus 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 이 위치의 Google 식별자(형식: |
read_mask |
선택사항입니다. 반환할 특정 필드입니다. 마스크를 지정하지 않으면 전체 FoodMenu('*'와 동일)를 반환합니다. 반복되는 필드 항목은 개별적으로 지정할 수 없습니다. 예를 들어 'name' 및 'menus'는 유효한 마스크이지만 'menus.sections'는 유효하지 않습니다. |
GetHealthProviderAttributesRequest
HealthProviderAttributes.GetHealthProviderAttributes 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 이 위치의 Google 식별자로, accounts/{account_id}/locations/{location_id}/healthProviderAttributes 형식입니다. |
language_code |
선택사항입니다. 언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다. 지금은 'en'만 지원됩니다. |
GetLocalPostRequest
LocalPosts.GetLocalPost 요청 메시지입니다.
필드 | |
---|---|
name |
가져올 지역 게시물의 이름입니다. |
GetLocationRequest
Locations.GetLocation 요청 메시지입니다.
필드 | |
---|---|
name |
가져올 위치의 이름입니다. |
GetMediaItemRequest
Media.GetMediaItem 요청 메시지입니다.
필드 | |
---|---|
name |
요청된 미디어 항목의 이름입니다. |
GetNotificationsRequest
Accounts.GetNotifications 요청 메시지입니다.
필드 | |
---|---|
name |
알림 설정 리소스 이름입니다. |
GetReviewRequest
Reviews.GetReview 요청 메시지입니다.
필드 | |
---|---|
name |
가져올 리뷰의 이름입니다. |
GetServiceListRequest
서비스 목록 요청 메시지를 가져옵니다.
필드 | |
---|---|
name |
필수 항목입니다. 이 위치의 Google 식별자(형식: |
GoogleLocation
Google에 있는 Location
를 나타냅니다. 이 위치는 사용자 또는 다른 사용자가 소유권을 주장했거나 소유권을 주장하지 않을 수 있는 위치일 수 있습니다.
필드 | |
---|---|
name |
이 GoogleLocation의 리소스 이름으로, |
location |
희소하게 채워진 |
request_admin_rights_url |
사용자를 관리자 권한 요청 UI로 리디렉션하는 URL입니다. 이 필드는 현재 사용자를 포함하여 다른 사용자가 이미 위치의 소유권을 주장한 경우에만 표시됩니다. |
GoogleUpdatedLocation
Google에서 수정한 위치를 나타냅니다.
필드 | |
---|---|
location |
이 위치의 Google 업데이트 버전입니다. |
diff_mask |
Google에서 업데이트한 필드 |
HealthProviderAttributes
이 위치와 연결된 의료인 속성입니다.
필드 | |
---|---|
name |
필수 항목입니다. 이 위치의 Google 식별자(형식: |
insurance_networks[] |
선택사항입니다. 이 위치에서 적용되는 보험 네트워크의 목록입니다. |
InsuranceNetwork
단일 보험 네트워크 다음 ID: 5
필드 | |
---|---|
network_id |
필수 항목입니다. Google에서 생성한 이 보험 네트워크의 ID입니다. |
network_names |
출력 전용. 요청된 언어로 된 네트워크 표시 이름 맵입니다. 여기서 언어는 키이고 현지화된 표시 이름은 값입니다. 기본적으로 영어로 된 표시 이름이 설정되어 있습니다. |
payer_names |
출력 전용. 요청된 언어로 된 결제자 표시 이름 맵입니다. 여기서 언어는 키이고 현지화된 표시 이름은 값입니다. 기본적으로 영어로 된 표시 이름이 설정되어 있습니다. |
state |
출력 전용. 이 보험 네트워크의 상태입니다. |
InternalError
내부 오류를 설명합니다.
필드 | |
---|---|
error_details[] |
개별 오류를 자세히 설명합니다. |
초대장
출력 전용. 대기 중인 초대를 나타냅니다.
필드 | ||
---|---|---|
name |
초대의 리소스 이름입니다. |
|
role |
계정의 초대된 역할 |
|
통합 필드 target . 이 초대의 대상을 나타냅니다. target 은 다음 중 하나여야 합니다. |
||
target_account |
이 초대장에 사용되는 계정의 사용자 밀도가 낮습니다. |
|
target_location |
이 초대의 대상 위치입니다. |
TargetLocation
대기 중인 초대의 대상 위치를 나타냅니다.
필드 | |
---|---|
location_name |
사용자가 초대된 위치의 이름입니다. |
location_address |
사용자가 초대된 위치의 주소입니다. |
ListAccountAdminsRequest
AccessControl.ListAccountAdmins에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
관리자 목록을 검색할 계정의 이름입니다. |
ListAccountAdminsResponse
AccessControl.ListAccountAdmins의 응답 메시지입니다.
필드 | |
---|---|
admins[] |
|
ListAccountsRequest
Accounts.ListAccounts의 요청 메시지입니다.
필드 | |
---|---|
page_size |
페이지당 가져올 계정 수입니다. 기본값은 20, 최소는 2, 최대 페이지 크기는 20입니다. |
page_token |
지정하면 계정의 다음 페이지가 검색됩니다. |
name |
직접 액세스할 수 있는 계정 목록을 가져올 계정의 리소스 이름입니다. 이는 조직 및 사용자 그룹에만 적용됩니다. 비어 있으면 인증된 사용자의 |
filter |
계정의 반환을 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. 예를 들어 |
ListAccountsResponse
Accounts.ListAccounts의 응답 메시지입니다.
필드 | |
---|---|
accounts[] |
사용자가 액세스할 수 있는 계정의 모음입니다. 쿼리를 수행하는 사용자의 개인 계정이 필터링되지 않는 한 항상 결과의 첫 번째 항목이 됩니다. |
next_page_token |
계정 수가 요청된 페이지 크기를 초과하면 이 필드는 |
ListAnswersRequest
QuestionsAndAnswers.ListAnswers 요청 메시지입니다.
필드 | |
---|---|
parent |
답변을 가져올 질문의 이름입니다. |
page_size |
페이지당 가져올 답변 수입니다. 기본 및 최대 |
page_token |
지정하면 답변의 다음 페이지가 검색됩니다. |
order_by |
답변을 반환하는 순서입니다. 유효한 옵션으로는 'update_time desc'와 'upvote_count desc'가 있습니다. 이 경우 요청된 필드를 기준으로 내림차순으로 정렬된 답변을 반환합니다. 기본 정렬 순서는 'update_time desc'입니다. |
ListAnswersResponse
QuestionsAndAnswers.List Answers에 대한 응답 메시지입니다.
필드 | |
---|---|
answers[] |
요청된 답변입니다. |
total_size |
모든 페이지에서 이 질문에 대해 게시된 총 답변 수입니다. |
next_page_token |
답변 수가 요청된 최대 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 답변 페이지를 가져오는 토큰으로 채워집니다. 더 이상 답변이 없으면 응답에 이 필드가 표시되지 않습니다. |
ListAttributeMetadataRequest
Locations.ListAttributeMetadata 요청 메시지입니다. 위치 리소스 이름을 입력하면 해당 위치가 나머지 기준을 채우는 데 사용됩니다. 없는 경우 카테고리와 국가를 입력해야 합니다.
필드 | |
---|---|
name |
사용 가능한 속성을 조회할 위치의 리소스 이름입니다. |
category_id |
사용 가능한 속성을 찾기 위한 기본 카테고리의 안정적인 ID입니다. |
country |
사용 가능한 속성을 찾기 위한 ISO 3166-1 alpha-2 국가 코드입니다. |
language_code |
속성 표시 이름을 가져올 BCP 47 언어 코드입니다. 이 언어를 사용할 수 없는 경우 영어로 제공됩니다. |
page_size |
페이지당 포함할 속성 수입니다. 기본값은 200, 최솟값은 1입니다. |
page_token |
지정하면 속성 메타데이터의 다음 페이지가 검색됩니다. |
ListAttributeMetadataResponse
Locations.ListAttributeMetadata의 응답 메시지입니다.
필드 | |
---|---|
attributes[] |
사용 가능한 속성의 속성 메타데이터 모음입니다. |
next_page_token |
속성 수가 요청된 페이지 크기를 초과하면 이 필드는 |
ListBusinessCategoriesRequest
필드 | |
---|---|
region_code |
ISO 3166-1 alpha-2 국가 코드입니다. |
language_code |
BCP 47 언어 코드입니다. 언어를 사용할 수 없는 경우 영어로 기본 설정됩니다. |
search_term |
사용자의 필터 문자열(선택사항)입니다. |
page_size |
페이지당 가져올 카테고리 수입니다. 기본값은 100, 최소는 1, 최대 페이지 크기는 100입니다. |
page_token |
지정하면 카테고리의 다음 페이지를 가져옵니다. |
view |
선택사항입니다. 카테고리 리소스에 대해 응답으로 반환해야 하는 부분을 지정합니다. |
ListBusinessCategoriesResponse
필드 | |
---|---|
categories[] |
카테고리입니다. 카테고리는 기본 보기입니다. ServiceType 정보를 포함하지 않습니다. |
total_category_count |
요청 매개변수의 총 카테고리 수입니다. |
next_page_token |
카테고리 수가 요청된 페이지 크기를 초과하면 이 필드는 |
ListCustomerMediaItemsRequest
Media.ListCustomerMediaItems 요청 메시지입니다.
필드 | |
---|---|
parent |
고객 미디어 항목이 나열될 위치의 이름입니다. |
page_size |
페이지당 반환할 미디어 항목의 수입니다. 기본값은 100이며 지원되는 최대 페이지 크기는 200입니다. |
page_token |
지정하면 미디어 항목의 다음 페이지가 반환됩니다. |
ListCustomerMediaItemsResponse
Media.ListCustomerMediaItems 응답 메시지입니다.
필드 | |
---|---|
media_items[] |
반환된 미디어 항목 목록입니다. |
total_media_item_count |
페이지로 나누기와 관계없이 이 위치의 총 미디어 항목 수입니다. 특히 여러 개의 결과 페이지가 있는 경우 이 값은 근사치입니다. |
next_page_token |
요청된 페이지 크기보다 더 많은 미디어 항목이 있는 경우 ListCustomerMediaItems에 대한 후속 호출에서 미디어 항목의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다. |
ListInsuranceNetworksRequest
InsuranceNetworkService.ListInsuranceNetworks 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 보험 네트워크가 나열될 위치의 이름입니다. 이름의 형식은 다음과 같습니다. accounts/{account_id}/locations/{location_id} |
language_code |
선택사항입니다. 언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다. 지금은 'en'만 지원됩니다. |
page_size |
페이지당 반환할 보험 네트워크의 수입니다. 기본값은 5,000입니다. 최대 페이지 크기는 10,000입니다. |
page_token |
지정하면 보험 네트워크의 다음 페이지가 반환됩니다. |
ListInsuranceNetworksResponse
InsuranceNetworkService.ListInsuranceNetworks의 응답 메시지입니다.
필드 | |
---|---|
networks[] |
Google에서 지원하는 보험 네트워크의 목록입니다. |
next_page_token |
요청된 페이지 크기보다 보험 네트워크가 더 많은 경우 ListInsuranceNetworks에 대한 후속 호출에서 보험 네트워크의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다. |
ListInvitationsRequest
AccessControl.ListInvitations 요청 메시지입니다.
필드 | |
---|---|
parent |
초대 목록을 가져오는 계정의 이름입니다. |
target_type |
응답에 표시되어야 하는 타겟 유형을 지정합니다. |
TargetType
초대 대상의 유형입니다.
열거형 | |
---|---|
ALL |
모든 대상 유형에 대한 초대를 나열합니다. 이는 기본값입니다. |
ACCOUNTS_ONLY |
계정 유형의 대상에 대한 초대만 나열합니다. |
LOCATIONS_ONLY |
위치 유형의 대상에 대한 초대만 나열합니다. |
ListInvitationsResponse
AccessControl.ListInvitations의 응답 메시지입니다.
필드 | |
---|---|
invitations[] |
계정에서 대기 중인 위치 초대 모음입니다. 여기에 표시된 초대장 수는 1,000개를 초과할 수 없습니다. |
ListLocalPostsRequest
ListLocalPosts 요청 메시지입니다.
필드 | |
---|---|
parent |
지역 게시물이 표시될 위치의 이름입니다. |
page_size |
페이지당 반환할 지역 게시물 수입니다. 기본값은 20입니다. 최소 1, 최대 페이지 크기는 100입니다. |
page_token |
지정하면 지역 게시물의 다음 페이지가 반환됩니다. |
ListLocalPostsResponse
ListLocalPosts의 응답 메시지입니다.
필드 | |
---|---|
local_posts[] |
반환된 지역 게시물 목록입니다. |
next_page_token |
요청된 페이지 크기보다 로컬 게시물이 더 많은 경우, |
ListLocationAdminsRequest
AccessControl.ListLocationAdmins의 요청 메시지입니다.
필드 | |
---|---|
parent |
관리자를 나열할 위치의 이름입니다. |
ListLocationAdminsResponse
AccessControl.ListLocationAdmins의 응답 메시지입니다.
필드 | |
---|---|
admins[] |
|
ListLocationsRequest
Locations.ListLocations 요청 메시지입니다.
필드 | |
---|---|
parent |
위치를 가져올 계정의 이름입니다. |
page_size |
페이지당 가져올 위치 수입니다. 기본값은 100, 최소는 1, 최대 페이지 크기는 100입니다. |
page_token |
지정하면 위치의 다음 |
filter |
반환할 위치를 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. 유효한 입력란과 사용 예에 대한 자세한 내용은 위치 데이터 사용 가이드를 참고하세요. |
language_code |
디스플레이 위치 속성을 가져올 BCP 47 언어 코드입니다. 이 언어를 사용할 수 없는 경우 해당 지역의 언어로 제공됩니다. 둘 다 사용할 수 없는 경우에는 영어로 제공됩니다. 지원이 중단되었습니다. 2020년 8월 15일 이후에는 이 필드가 더 이상 적용되지 않습니다. 대신 위치의 언어가 항상 사용됩니다. |
order_by |
요청의 정렬 순서입니다. 여러 필드는 SQL 구문에 따라 쉼표로 구분되어야 합니다. 기본 정렬 순서는 오름차순입니다. 내림차순을 지정하려면 접미사 ' desc'를 추가해야 합니다. order_by로 사용할 수 있는 유효한 필드는 location_name 및 store_code입니다. 예: 'location_name, store_code desc', 'location_name', 'store_code desc' |
ListLocationsResponse
Locations.ListLocations의 응답 메시지입니다.
필드 | |
---|---|
locations[] |
위치입니다. |
next_page_token |
위치 수가 요청된 페이지 크기를 초과하면 이 필드는 |
total_size |
페이지로 나누기와 관계없이 목록에 있는 대략적인 위치 수입니다. |
ListMediaItemsRequest
Media.ListMediaItems 요청 메시지입니다.
필드 | |
---|---|
parent |
미디어 항목이 나열될 위치의 이름입니다. |
page_size |
페이지당 반환할 미디어 항목의 수입니다. 기본값은 100이며, 이는 Google My Business API를 사용하여 위치에 추가할 수 있는 최대 미디어 항목 수이기도 합니다. 최대 페이지 크기는 2,500입니다. |
page_token |
지정하면 미디어 항목의 다음 페이지가 반환됩니다. |
ListMediaItemsResponse
Media.ListMediaItems의 응답 메시지입니다.
필드 | |
---|---|
media_items[] |
반환된 미디어 항목 목록입니다. |
total_media_item_count |
페이지로 나누기와 관계없이 이 위치의 총 미디어 항목 수입니다. |
next_page_token |
요청된 페이지 크기보다 더 많은 미디어 항목이 있는 경우 ListMediaItems에 대한 후속 호출에서 미디어 항목의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다. |
ListQuestionsRequest
QuestionsAndAnswers.ListQuestions 요청 메시지입니다.
필드 | |
---|---|
parent |
질문을 가져올 위치의 이름입니다. |
page_size |
페이지당 가져올 질문 수입니다. 기본 및 최대 |
page_token |
지정하면 다음 질문 페이지가 검색됩니다. |
answers_per_question |
질문당 가져올 답변의 수입니다. 기본 및 최대 |
filter |
질문의 반환을 제한하는 필터입니다. 현재 지원되는 유일한 필터는 'ignore_answered=true'입니다. |
order_by |
질문을 반환하기 위한 순서입니다. 유효한 옵션으로는 'update_time desc'와 'upvote_count desc'가 있습니다. 이 경우 요청된 필드를 기준으로 내림차순으로 정렬된 질문이 반환됩니다. 기본 정렬 순서는 'update_time desc'입니다. |
ListQuestionsResponse
QuestionsAndAnswers.ListQuestions에 대한 응답 메시지입니다.
필드 | |
---|---|
questions[] |
요청된 질문은 |
total_size |
모든 페이지에서 이 위치에 대해 게시된 총 질문 수입니다. |
next_page_token |
질문 수가 요청된 최대 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 질문 페이지를 가져오는 토큰으로 채워집니다. 질문이 더 이상 없으면 응답에 이 필드가 표시되지 않습니다. |
ListRecommendedGoogleLocationsRequest
비즈니스 프로필 계정의 추천 위치 목록을 요청하는 메시지 요청
필드 | |
---|---|
name |
추천 Google 위치를 가져올 계정 리소스의 이름입니다. |
page_size |
페이지당 가져올 위치 수입니다. 기본값은 25, 최소는 1, 최대 페이지 크기는 100입니다. |
page_token |
지정하면 위치의 다음 페이지가 검색됩니다. |
ListRecommendedGoogleLocationsResponse
GoogleLocations.ListRecommendedGoogleLocations의 응답 메시지입니다.
또한 이 비즈니스 프로필 계정에 마지막으로 추천된 이후 다른 비즈니스 프로필 사용자가 소유권을 주장한 일부 위치도 포함됩니다.
필드 | |
---|---|
google_locations[] |
비즈니스 프로필 계정에 추천된 위치입니다. 이러한 각 요소는 지도에 있는 |
total_size |
페이지로 나누기와 관계없이 이 비즈니스 프로필 계정에 추천되는 총 위치 수입니다. |
next_page_token |
페이지로 나누기 중에 다음 페이지에 가져올 수 있는 위치가 더 있는 경우 후속 호출에서 다음 위치 페이지를 가져오는 토큰으로 이 필드가 채워집니다. 가져올 위치가 더 이상 없으면 이 필드는 응답에 표시되지 않습니다. |
ListReviewsRequest
Reviews.ListReviews 요청 메시지입니다.
필드 | |
---|---|
parent |
리뷰를 가져올 위치의 이름입니다. |
page_size |
페이지당 가져올 리뷰 수입니다. 최대 |
page_token |
지정하면 다음 리뷰 페이지를 가져옵니다. |
order_by |
리뷰 정렬의 기준이 될 필드를 지정합니다. 지정하지 않으면 반환되는 리뷰 순서가 기본적으로 |
ListReviewsResponse
Reviews.ListReviews의 응답 메시지입니다.
필드 | |
---|---|
reviews[] |
리뷰입니다. |
average_rating |
이 위치에 대한 모든 리뷰의 평균 별표 평점(1~5점)으로, 5가 가장 높은 평점입니다. |
total_review_count |
이 위치에 대한 총 리뷰 수입니다. |
next_page_token |
리뷰 수가 요청된 페이지 크기를 초과하면 이 필드는 ListReviews에 대한 후속 호출에서 다음 리뷰 페이지를 가져오는 토큰으로 채워집니다. 리뷰가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다. |
ListVerificationsRequest
Verifications.ListVerifications 요청 메시지입니다.
필드 | |
---|---|
parent |
인증 요청이 속한 위치의 리소스 이름입니다. |
page_size |
페이지당 포함할 인증 수입니다. 설정하지 않으면 모두 반환합니다. |
page_token |
지정하면 다음 인증 페이지가 반환됩니다. |
ListVerificationsResponse
Verifications.ListVerifications의 응답 메시지입니다.
필드 | |
---|---|
verifications[] |
인증 목록입니다. |
next_page_token |
인증 수가 요청된 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 인증 페이지를 가져오는 토큰으로 채워집니다. 속성이 더 이상 없으면 이 필드는 응답에 표시되지 않습니다. |
LocalPost
위치의 지역 게시물을 나타냅니다.
필드 | |
---|---|
name |
출력 전용. 이 지역 게시물의 Google 식별자입니다. 형식: |
language_code |
지역 게시물의 언어입니다. |
summary |
지역 게시물의 설명/본문입니다. |
call_to_action |
사용자가 프로모션을 클릭하면 연결되는 URL입니다. 주제 유형 |
create_time |
출력 전용. 게시물 작성 시간입니다. |
update_time |
출력 전용. 사용자가 마지막으로 게시물을 수정한 시간입니다. |
event |
일정 정보입니다. 주제 유형 |
state |
출력 전용. 게시물의 수명 주기 중 어느 부분에 있는지 나타내는 게시물의 상태입니다. |
media[] |
게시물과 연결된 미디어입니다. source_url은 LocalPost MediaItem에 대해 지원되는 유일한 데이터 필드입니다. |
search_url |
출력 전용. Google 검색에 표시되는 지역 게시물 링크입니다. 이 링크는 소셜 미디어, 이메일, 텍스트 등을 통해 게시물을 공유하는 데 사용할 수 있습니다. |
topic_type |
필수 항목입니다. 게시물의 주제 유형(일반, 이벤트, 혜택, 알림)입니다. |
alert_type |
게시물이 생성되는 알림의 유형입니다. 이 필드는 topic_type 알림의 게시물에만 적용되며 알림의 하위 유형으로 동작합니다. |
offer |
혜택 게시물에 대한 추가 데이터입니다. topic_type이 OFFER인 경우에만 설정해야 합니다. |
LocalPostState
게시물의 상태를 나타냅니다.
열거형 | |
---|---|
LOCAL_POST_STATE_UNSPECIFIED |
상태가 지정되지 않았습니다. |
REJECTED |
이 게시물은 콘텐츠 정책 위반으로 인해 거부되었습니다. |
LIVE |
이 게시물은 게시되었으며 현재 검색결과에 표시되고 있습니다. |
PROCESSING |
이 게시물은 처리 중이며 검색결과에 표시되지 않습니다. |
LocalPostEvent
지역 게시물에 표시된 이벤트와 관련된 모든 정보입니다.
필드 | |
---|---|
title |
이벤트 이름입니다. |
schedule |
일정 시작 및 종료 날짜/시간 |
LocalPostMetrics
지역 게시물에 요청된 모든 측정항목입니다.
필드 | |
---|---|
local_post_name |
|
metric_values[] |
요청된 측정항목의 값 목록입니다. |
LocalPostOffer
쿠폰 게시물의 특정 필드입니다.
필드 | |
---|---|
coupon_code |
선택사항입니다. 매장 또는 온라인에서 사용할 수 있는 쿠폰 코드입니다. |
redeem_online_url |
선택사항입니다. 쿠폰을 사용할 수 있는 온라인 링크입니다. |
terms_conditions |
선택사항입니다. 쿠폰 이용약관입니다. |
LocalPostTopicType
지역 게시물의 주제 유형으로, 게시물을 만들고 렌더링하는 다양한 템플릿을 선택하는 데 사용됩니다.
열거형 | |
---|---|
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED |
지정된 게시물 유형이 없습니다. |
STANDARD |
게시물에 요약 및 이미지와 같은 기본 정보가 포함됩니다. |
EVENT |
게시물에 기본 정보와 이벤트가 포함됩니다. |
OFFER |
게시물에 기본 정보, 이벤트, 혜택 관련 콘텐츠 (예: 쿠폰 코드)가 포함됩니다. |
ALERT |
진행 중인 이벤트와 관련된 우선순위가 높고 시기적절한 공지입니다. 이러한 유형의 게시물을 항상 작성할 수 있는 것은 아닙니다. |
위치
위치 이러한 입력란에 대한 자세한 설명은 고객센터 도움말을 참고하고 유효한 비즈니스 카테고리 목록은 카테고리 엔드포인트를 참고하세요.
필드 | |
---|---|
name |
이 위치의 Google 식별자(형식: 일치 컨텍스트에서는 이 필드가 채워지지 않습니다. |
language_code |
위치의 언어입니다. 생성 중에 설정되며 업데이트할 수 없습니다. |
store_code |
이 위치의 외부 식별자로, 지정된 계정 내에서 고유해야 합니다. 위치를 자신의 레코드와 연결하는 방법입니다. |
location_name |
위치 이름은 오프라인 매장, 웹사이트, 회사 서간지에서 일관되게 사용되고 고객에게 알려져 있는 비즈니스의 실제 이름을 반영해야 합니다. 추가 정보는 해당하는 경우 리소스의 다른 필드 (예: |
primary_phone |
가능한 한 개별 업체 위치로 직접 연결되는 전화번호입니다. 가능하면 중앙의 콜센터 전화번호가 아닌 지역 전화번호를 사용하세요. |
additional_phones[] |
기본 전화번호 외에 비즈니스에 연락할 수 있는 전화번호 (휴대전화 또는 유선 전화번호)입니다. 최대 2개까지 추가할 수 있으며 팩스 번호는 사용할 수 없습니다. |
address |
정확한 주소를 사용해 업체 위치를 설명하세요. 원격 위치에 있는 사서함이나 우편함은 사용할 수 없습니다. 현재는 주소에 최대 5개의 |
primary_category |
이 위치가 수행하는 핵심 비즈니스를 가장 잘 설명하는 카테고리입니다. |
additional_categories[] |
비즈니스를 설명하는 추가 카테고리입니다. 카테고리를 지정해 두면 고객이 관심 있는 서비스를 정확하게 찾을 수 있습니다. 비즈니스 정보를 최신 상태로 정확하게 유지하려면 전체 핵심 비즈니스를 설명하는 카테고리를 가능한 한 적게 사용해야 합니다. 최대한 구체적이면서 주 비즈니스를 대표하는 카테고리를 선택하세요. |
website_url |
이 비즈니스의 URL입니다. 가능하면 모든 위치 또는 브랜드를 나타내는 일반 웹사이트/URL 대신 이 개별 업체 위치를 나타내는 URL을 사용하세요. |
regular_hours |
비즈니스의 영업시간입니다. |
special_hours |
비즈니스의 특별 영업시간입니다. 일반적으로 휴일 영업시간과 정규 영업시간 외의 기타 시간도 포함됩니다. 이 영업시간은 정규 영업시간보다 우선합니다. |
service_area |
방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다. 방문 서비스 업체인 경우, 이 필드는 업체가 서비스를 제공하는 지역을 설명합니다. |
location_key |
이 비즈니스를 Google+ 페이지, Google 지도 장소 등 다른 Google 서비스에 연결하는 키 컬렉션입니다. |
labels[] |
비즈니스에 태그를 지정할 수 있는 자유형 문자열 컬렉션입니다. 이러한 라벨은 사용자에게 표시되지 않으며 나만 볼 수 있습니다. 255자(영문 기준)로 제한됩니다(라벨당). |
ad_words_location_extensions |
애드워즈에 표시되는 추가 정보입니다. |
latlng |
사용자가 제공한 위도 및 경도입니다. 위치를 생성할 때 제공된 주소가 성공적으로 지오코딩되면 이 필드는 무시됩니다. 이 필드는 사용자가 제공한 |
open_info |
위치가 현재 영업 중인지 여부를 나타내는 플래그. |
location_state |
출력 전용. 위치의 상태를 반영하는 부울 집합입니다. |
attributes[] |
이 위치의 속성입니다. |
metadata |
출력 전용. 사용자가 수정할 수 없는 추가 정보입니다. |
price_lists[] |
지원 중단됨: 이 위치의 가격 목록 정보입니다. |
profile |
비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다. |
relationship_data |
이 매장과 관련된 모든 매장 및 체인입니다. |
more_hours[] |
비즈니스의 여러 부서 또는 특정 고객에 대한 추가 영업시간입니다. |
메타데이터
사용자가 수정할 수 없는 추가 위치 정보입니다.
필드 | |
---|---|
duplicate |
이 위치가 중복된 위치에 대한 정보입니다. |
maps_url |
지도상의 위치에 대한 링크입니다. |
new_review_url |
고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지의 링크입니다. |
복사
이 위치가 중복된 위치에 대한 정보입니다.
필드 | |
---|---|
location_name |
중복된 위치의 리소스 이름입니다. 인증된 사용자에게 해당 위치에 대한 액세스 권한이 있고 해당 위치가 삭제되지 않은 경우에만 채워집니다. |
place_id |
중복된 위치의 장소 ID입니다. |
access |
중복된 위치에 사용자가 액세스할 수 있는지 여부를 나타냅니다. |
액세스
중복된 위치에 대한 사용자의 액세스 수준입니다. 이 소유권은 소유권을 대체하며 대신 사용해야 합니다.
열거형 | |
---|---|
ACCESS_UNSPECIFIED |
지정되지 않음 |
ACCESS_UNKNOWN |
사용자가 중복된 위치에 액세스할 수 있는지 확인할 수 없습니다. |
ALLOWED |
사용자가 동일한 위치에 액세스할 수 있습니다. |
INSUFFICIENT |
사용자에게 중복된 위치에 액세스할 수 있는 권한이 없습니다. |
RelationshipData
이 위치와 관련된 모든 상위 및 하위 위치의 정보입니다.
필드 | |
---|---|
parent_chain |
이 위치가 속한 체인의 리소스 이름입니다. |
LocationDrivingDirectionMetrics
사람들이 보통 출근하는 지역으로 색인이 생성된 위치입니다. 이는 각 지역에서 이 위치로 이동하는 운전 경로 요청 수를 계산하여 캡처합니다.
필드 | |
---|---|
location_name |
이 측정항목 값이 속한 위치 리소스 이름입니다. |
top_direction_sources[] |
소스 지역별 운전 경로 요청입니다. 규칙에 따라 최대 10개의 결과로 개수별로 정렬됩니다. |
time_zone |
위치의 시간대입니다 (IANA 시간대 ID, 예: '유럽/런던'). |
TopDirectionSources
운전 경로 요청이 발생한 상위 지역입니다.
필드 | |
---|---|
day_count |
일 수 데이터가 집계됩니다. |
region_counts[] |
지역이 개수 기준 내림차순으로 정렬됩니다. |
RegionCount
연결된 요청 수가 있는 지역입니다.
필드 | |
---|---|
latlng |
리전의 중심입니다. |
label |
사람이 읽을 수 있는 리전의 라벨입니다. |
count |
이 지역의 운전 경로 요청 수입니다. |
LocationKey
위치의 대체/서로게이트 키 참조입니다.
필드 | |
---|---|
plus_page_id |
출력 전용. 위치에 연결된 Google+ 페이지가 있는 경우 이 위치의 Google+ 페이지 ID로 채워집니다. |
place_id |
이 위치가 인증되어 Google 지도에 연결/표시되는 경우 이 필드는 위치의 장소 ID로 채워집니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다. 위치가 인증되지 않은 경우, 이 필드는 위치가 Google 지도에 표시되는 장소와 연결된 경우 채워집니다. 이 필드는 Create 호출 중에 설정할 수 있지만 Update 호출 중에는 설정할 수 없습니다. 추가 |
explicit_no_place_id |
출력 전용. true 값은 설정되지 않은 장소 ID가 의도적임을 나타내며, 아직 연결되지 않은 것과는 다릅니다. |
request_id |
출력 전용. 이 위치를 만드는 데 사용된 |
LocationMetrics
일정 기간 동안 위치와 연결된 일련의 측정항목 및 BreakdownMetrics입니다.
필드 | |
---|---|
location_name |
값이 속한 위치 리소스 이름입니다. |
time_zone |
위치의 IANA 시간대입니다. |
metric_values[] |
요청된 측정항목의 값 목록입니다. |
LocationReview
위치 정보가 있는 리뷰를 나타냅니다.
필드 | |
---|---|
name |
위치 리소스 이름입니다. |
review |
위치에 대한 리뷰입니다. |
LocationState
Location의 상태를 반영하는 부울 집합이 포함됩니다.
필드 | |
---|---|
is_google_updated |
출력 전용. 이 위치에 연결된 장소 ID에 업데이트가 있는지 여부를 나타냅니다. |
is_duplicate |
출력 전용. 위치가 다른 위치와 중복되는지 여부를 나타냅니다. |
is_suspended |
출력 전용. 위치가 정지되었는지 여부를 나타냅니다. 일시중지된 위치는 Google 제품의 최종 사용자에게 표시되지 않습니다. 실수라고 생각되면 고객센터 도움말을 참조하세요. |
can_update |
출력 전용. 위치를 업데이트할 수 있는지 여부를 나타냅니다. |
can_delete |
출력 전용. Google My Business API를 사용하여 위치를 삭제할 수 있는지 여부를 나타냅니다. |
is_verified |
출력 전용. 위치가 인증되었는지 여부를 나타냅니다. |
needs_reverification |
출력 전용. 위치에 재인증이 필요한지 여부를 나타냅니다. |
is_pending_review |
출력 전용. 위치 검토가 대기 중인지 여부를 나타냅니다. |
is_disabled |
출력 전용. 위치가 사용 중지되었는지 여부를 나타냅니다. |
is_published |
출력 전용. 위치의 게시 여부를 나타냅니다. |
is_disconnected |
출력 전용. 위치가 Google 지도의 장소와 연결 해제되었는지 여부를 나타냅니다. |
is_local_post_api_disabled |
출력 전용. 이 위치에 accounts.locations.localPosts가 사용 중지되었는지 여부를 나타냅니다. |
can_modify_service_list |
출력 전용. 등록정보에서 ServiceList를 수정할 수 있는지 여부를 나타냅니다. |
can_have_food_menus |
출력 전용. 등록정보가 음식 메뉴에 적합한지 여부를 나타냅니다. |
has_pending_edits |
출력 전용. 이 위치의 속성이 수정 대기 중 상태에 있는지 여부를 나타냅니다. |
has_pending_verification |
출력 전용. 위치에 대기 중인 인증 요청이 있는지 여부를 나타냅니다. |
can_operate_health_data |
출력 전용. 위치가 건강 데이터를 활용할 수 있는지를 나타냅니다. |
can_operate_lodging_data |
출력 전용. 위치가 숙박 시설 데이터에서 운영할 수 있는지 여부를 나타냅니다. |
MatchedLocation
위치와 일치할 수 있는 항목을 나타냅니다.
필드 | |
---|---|
location |
인구 밀도가 낮고 일치 가능성이 있는 위치입니다. 채워지지 않은 필드에는 이름 (일치하는 위치는 |
is_exact_match |
일치검색인가요? |
MediaItem
단일 미디어 항목입니다.
필드 | ||
---|---|---|
name |
이 미디어 항목의 리소스 이름입니다. |
|
media_format |
이 미디어 항목의 형식입니다. 미디어 항목이 생성될 때 설정해야 하며, 다른 모든 요청에서 읽기 전용입니다. 이 설정은 업데이트할 수 없습니다. |
|
location_association |
|
|
google_url |
출력 전용. 이 미디어 항목에 대해 Google에서 호스팅하는 URL입니다. 이 URL은 시간이 지남에 따라 변경될 수 있으므로 정적이지 않습니다. 동영상의 경우 오버레이된 재생 아이콘이 있는 미리보기 이미지입니다. |
|
thumbnail_url |
출력 전용. 제공되는 경우 이 미디어 항목의 미리보기 이미지 URL입니다. |
|
create_time |
출력 전용. 이 미디어 항목의 생성 시간입니다. |
|
dimensions |
출력 전용. 픽셀 단위의 크기 (너비 및 높이)입니다. |
|
insights |
출력 전용. 이 미디어 항목에 대한 통계입니다. |
|
attribution |
출력 전용. 고객 미디어 항목의 저작자 표시 정보입니다. 이 저작자 표시를 사용자에게 제공한 대로 표시해야 하며 저작자 표시를 삭제하거나 변경해서는 안 됩니다. |
|
description |
이 미디어 항목의 설명입니다. 설명은 Google My Business API를 통해 수정할 수 없지만 표지 사진이 아닌 새 미디어 항목을 만들 때 설정할 수 있습니다. |
|
통합 필드
업로드된 모든 사진은 사진 관련 비즈니스 프로필 가이드라인을 준수해야 합니다. |
||
source_url |
미디어 항목을 가져올 수 있는 공개적으로 액세스 가능한 URL입니다. 이 소스 중 하나를 만들거나 data_ref를 설정하여 미디어 항목의 소스를 지정해야 합니다. 미디어 항목을 만들 때 이 필드는 업데이트할 수 없습니다. |
|
data_ref |
입력 전용. 미디어 항목을 만들 때
또는
를 설정해야 합니다. |
기여 분석
기여자의 이름 및 프로필 사진과 같은 고객 미디어 항목의 저작자 표시 정보입니다.
필드 | |
---|---|
profile_name |
미디어 항목의 기여자인 사용자 이름입니다. |
profile_photo_url |
기여 사용자의 프로필 사진 미리보기 이미지 URL입니다. |
takedown_url |
부적절한 미디어 항목을 신고할 수 있는 게시 중단 페이지의 URL입니다. |
profile_url |
기여 사용자의 Google 지도 프로필 페이지 URL입니다. |
크기
미디어 항목의 크기입니다.
필드 | |
---|---|
width_pixels |
미디어 항목의 너비(픽셀)입니다. |
height_pixels |
미디어 항목의 높이(픽셀)입니다. |
LocationAssociation
미디어 항목이 해당 위치에 연결되는 방식입니다.
필드 | ||
---|---|---|
통합 필드 location_attachment_type . 위치 미디어에는 카테고리 또는 연결된 가격 목록 항목의 ID가 있어야 합니다. 비위치 미디어 (예: 지역 게시물 사진)에는 둘 다 없어야 합니다. location_attachment_type 은 다음 중 하나여야 합니다. |
||
category |
이 위치 사진이 속한 카테고리입니다. |
|
price_list_item_id |
이 위치 사진과 연결된 가격 목록 항목의 ID입니다. |
카테고리
미디어 항목 카테고리의 열거형입니다.
열거형 | |
---|---|
CATEGORY_UNSPECIFIED |
카테고리가 지정되지 않았습니다. |
COVER |
표지 사진입니다. 위치에는 표지 사진이 하나만 있습니다. |
PROFILE |
프로필 사진입니다. 위치에는 프로필 사진이 하나만 있습니다. |
LOGO |
로고 사진입니다. |
EXTERIOR |
외부 미디어입니다. |
INTERIOR |
내부 미디어. |
PRODUCT |
제품 미디어입니다. |
AT_WORK |
'직장' 미디어입니다. |
FOOD_AND_DRINK |
식음료 미디어입니다. |
MENU |
메뉴 미디어입니다. |
COMMON_AREA |
공용 시설 미디어입니다. |
ROOMS |
채팅방 미디어입니다. |
TEAMS |
팀 미디어입니다. |
ADDITIONAL |
분류되지 않은 추가 미디어입니다. |
MediaFormat
미디어 형식의 열거형입니다.
열거형 | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
형식이 지정되지 않았습니다. |
PHOTO |
미디어 항목이 사진입니다. 이 버전에서는 사진만 지원됩니다. |
VIDEO |
미디어 항목이 동영상입니다. |
MediaInsights
미디어 항목에 대한 통계입니다.
필드 | |
---|---|
view_count |
출력 전용. 미디어 항목이 조회된 횟수입니다. |
MediaItemDataRef
Google My Business API를 통해 업로드된 MediaItem
의 사진 바이너리 데이터에 대한 참조입니다.
StartUploadMediaItemData
를 사용하여 데이터 참조를 만들고, 바이트를 [UpdateMedia] 에 업로드한 후 CreateMediaItem
를 호출할 때 이 참조를 사용합니다.
필드 | |
---|---|
resource_name |
이 미디어 항목의 바이너리 데이터의 고유 ID입니다. [UpdateMedia] 를 사용하여 사진 데이터를 업로드하고 바이트 업로드 예시:
|
MenuLabel
메뉴와 메뉴의 다양한 하위 구성요소를 표시할 때 사용되는 라벨입니다.
필드 | |
---|---|
display_name |
필수 항목입니다. 구성요소의 표시 이름입니다. |
description |
선택사항입니다. 구성요소의 추가 정보입니다. |
language_code |
선택사항입니다. BCP 47 언어 코드입니다. 언어를 사용할 수 없는 경우 영어로 기본 설정됩니다. |
측정항목
리소스에 대한 데이터 측정항목입니다.
열거형 | |
---|---|
METRIC_UNSPECIFIED |
지정된 측정항목이 없습니다. |
ALL |
사용 가능한 모든 측정항목을 요청하는 약식입니다. '전체'에 포함되는 측정항목은 다르며, 통계가 요청되는 리소스에 따라 다릅니다. |
QUERIES_DIRECT |
위치를 직접 검색할 때 리소스가 표시된 횟수입니다. |
QUERIES_INDIRECT |
카테고리 검색 (예: 식당)의 결과로 리소스가 표시된 횟수입니다. |
QUERIES_CHAIN |
리소스가 속한 체인이나 리소스가 판매하는 브랜드를 검색한 결과로 리소스가 표시된 횟수입니다. 예: Starbucks, 아디다스 QUERIES_INDIRECT의 하위 집합입니다. |
VIEWS_MAPS |
Google 지도에서 리소스가 조회된 횟수입니다. |
VIEWS_SEARCH |
Google 검색에서 리소스가 조회된 횟수입니다. |
ACTIONS_WEBSITE |
웹사이트가 클릭된 횟수입니다. |
ACTIONS_PHONE |
전화번호가 클릭된 횟수입니다. |
ACTIONS_DRIVING_DIRECTIONS |
운전 경로가 요청된 횟수입니다. |
PHOTOS_VIEWS_MERCHANT |
판매자가 업로드한 미디어 항목의 조회수입니다. |
PHOTOS_VIEWS_CUSTOMERS |
고객이 업로드한 미디어 항목의 조회수입니다. |
PHOTOS_COUNT_MERCHANT |
판매자가 업로드하였으며 현재 게시되어 있는 미디어 항목의 총 개수입니다. |
PHOTOS_COUNT_CUSTOMERS |
고객이 업로드한 현재 게시되어 있는 미디어 항목의 총 개수입니다. |
LOCAL_POST_VIEWS_SEARCH |
Google 검색에서 지역 게시물이 조회된 횟수입니다. |
LOCAL_POST_ACTIONS_CALL_TO_ACTION |
Google에서 클릭 유도 문구 버튼을 클릭한 횟수입니다. |
MetricOption
응답에 데이터가 표시되는 방식을 지정하는 옵션입니다.
열거형 | |
---|---|
METRIC_OPTION_UNSPECIFIED |
지정된 측정항목 옵션이 없습니다. 요청에서 기본값 AGGREGATED_TOTAL로 설정됩니다. |
AGGREGATED_TOTAL |
전체 기간에 걸쳐 집계된 값을 반환합니다. 기본값입니다. |
AGGREGATED_DAILY |
시간 범위에서 타임스탬프가 적용된 일일 값을 반환합니다. |
BREAKDOWN_DAY_OF_WEEK |
값은 요일별 분류로 반환됩니다. ACTIONS_PHONE에만 유효합니다. |
BREAKDOWN_HOUR_OF_DAY |
값은 시간별 분류로 반환됩니다. ACTIONS_PHONE에만 유효합니다. |
MetricRequest
하나의 측정항목의 값과 해당 값을 반환하는 방식에 대한 옵션을 반환하기 위한 요청입니다.
필드 | |
---|---|
metric |
요청된 측정항목입니다. |
options[] |
반환될 때 값이 표시되는 방식입니다. |
MetricValue
시작 시간의 단일 측정항목 값입니다.
필드 | |
---|---|
metric |
값이 적용되는 측정항목입니다. |
total_value |
이 측정항목의 총 집계 값입니다. AGGREGATED_TOTAL 옵션에 대해 설정합니다. |
dimensional_values[] |
이 측정항목의 측정기준 값입니다. |
MoreHours
특정 유형의 비즈니스에 위치가 영업하는 기간입니다.
필드 | |
---|---|
hours_type_id |
필수 항목입니다. 시간 유형입니다. 고객은 {#link businessCategories:BatchGet}을(를) 호출하여 위치 카테고리에 대해 지원되는 시간 유형을 가져와야 합니다. |
periods[] |
필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다. |
MoreHoursType
정상 영업시간 외에 비즈니스에서 제공할 수 있는 추가 영업시간 유형입니다.
필드 | |
---|---|
hours_type_id |
출력 전용. Google에서 이 영업시간 유형에 제공하는 안정적인 ID입니다. |
display_name |
출력 전용. 사람이 읽을 수 있는 시간 유형의 영어 표시 이름입니다. |
localized_display_name |
출력 전용. 사람이 읽을 수 있는 시간 유형의 현지화된 표시 이름입니다. |
NetworkState
이 위치와 관련된 보험 네트워크의 상태입니다.
열거형 | |
---|---|
NETWORK_STATE_UNSPECIFIED |
기본값 |
ACCEPTED |
이 위치에서 허용되는 네트워크입니다. |
PENDING_ADD |
이 네트워크를 허용 목록에 추가해 달라는 요청이 대기 중입니다. |
PENDING_DELETE |
허용 목록에서 이 네트워크를 삭제해 달라는 요청이 대기 중입니다. |
NOT_ACCEPTED |
이 위치에서 허용되지 않는 네트워크입니다. |
NotificationType
Cloud Pub/Sub 주제로 전송된 알림 유형입니다.
열거형 | |
---|---|
NOTIFICATION_TYPE_UNSPECIFIED |
알림 유형이 없습니다. 알림과 일치하지 않습니다. |
GOOGLE_UPDATE |
위치에 검토할 Google 업데이트가 있습니다. 알림의 location_name 입력란에는 Google 업데이트가 포함된 위치의 리소스 이름이 표시됩니다. |
NEW_REVIEW |
위치에 새 리뷰가 추가되었습니다. 알림의 review_name 입력란은 추가된 리뷰의 리소스 이름을 제공하며 location_name은 위치의 리소스 이름을 갖습니다. |
UPDATED_REVIEW |
위치에 대한 리뷰가 업데이트되었습니다. 알림의 review_name 입력란은 추가된 리뷰의 리소스 이름을 제공하며 location_name은 위치의 리소스 이름을 갖습니다. |
NEW_CUSTOMER_MEDIA |
Google 지도 사용자가 위치에 새 미디어 항목을 추가했습니다. 알림에서 새 미디어 항목의 리소스 이름을 제공합니다. |
NEW_QUESTION |
새 질문이 위치에 추가됩니다. 알림에 질문의 리소스 이름이 표시됩니다. |
UPDATED_QUESTION |
위치에 관한 질문이 업데이트되었습니다. 알림에 질문의 리소스 이름이 표시됩니다. |
NEW_ANSWER |
새 답변이 위치에 추가됩니다. 알림에 질문과 답변의 리소스 이름이 표시됩니다. |
UPDATED_ANSWER |
위치의 답변이 업데이트됩니다. 알림에 질문과 답변의 리소스 이름이 표시됩니다. |
UPDATED_LOCATION_STATE |
Location의 LocationState를 업데이트했습니다. 알림에는 업데이트된 LocationState 필드의 필드 마스크가 포함됩니다. |
알림
위치가 업데이트되거나 새 리뷰가 있으면 알림을 게시할 수 있는 Google Cloud Pub/Sub 주제입니다. 알림 설정 리소스는 계정당 하나만 있습니다.
필드 | |
---|---|
name |
출력 전용. 알림 리소스 이름입니다. |
topic_name |
이 계정에서 관리하는 위치가 업데이트되면 알림을 수신할 Google Cloud Pub/Sub 주제입니다. 설정하지 않으면 알림이 게시되지 않습니다. mybusiness-api-pubsub@system.gserviceaccount.com 계정에는 최소한 Cloud Pub/Sub 주제에 대한 게시 권한이 있어야 합니다. |
notification_types[] |
Cloud Pub/Sub 주제로 전송되는 알림 유형입니다. 최소 1개를 지정해야 합니다. 알림을 전혀 받지 않으려면 |
NutritionFacts
이 메시지는 음식의 영양 성분을 나타냅니다.
필드 | |
---|---|
calories |
선택사항입니다. 요리의 칼로리입니다. |
total_fat |
선택사항입니다. 특정 음식에 대한 지방 정보입니다. |
cholesterol |
선택사항입니다. 특정 음식의 콜레스테롤 정보입니다. |
sodium |
선택사항입니다. 특정 음식의 나트륨 정보입니다. |
total_carbohydrate |
선택사항입니다. 특정 음식에 대한 탄수화물 정보입니다. |
protein |
선택사항입니다. 주어진 음식의 단백질 정보입니다. |
CaloriesFact
이 메시지는 상한값 및 하한값 범위로 칼로리 정보를 표시합니다. 더 낮은 금액을 지정해야 합니다. 낮은 금액과 높은 금액은 모두 음수가 아닙니다.
필드 | |
---|---|
lower_amount |
필수 항목입니다. 낮은 칼로리 |
upper_amount |
선택사항입니다. 상한 칼로리 |
unit |
필수 항목입니다. 주어진 칼로리 정보의 단위입니다. |
EnergyUnit
가능한 식품 에너지 단위 (칼로리)
열거형 | |
---|---|
ENERGY_UNIT_UNSPECIFIED |
에너지 단위 미지정 |
CALORIE |
칼로리 |
JOULE |
줄 |
MassUnit
가능한 질량 단위입니다.
열거형 | |
---|---|
MASS_UNIT_UNSPECIFIED |
대량 단위 미지정 |
GRAM |
Gram |
MILLIGRAM |
밀리그램 |
NutritionFact
이 메시지는 상한값과 하한값 범위로 영양 정보를 나타내며 질량 단위로 나타낼 수 있습니다. 더 낮은 금액을 지정해야 합니다. 낮은 금액과 높은 금액은 모두 음수가 아닙니다.
필드 | |
---|---|
lower_amount |
필수 항목입니다. 영양 함량 낮음 |
upper_amount |
선택사항입니다. 높은 영양 함량 |
unit |
필수 항목입니다. 주어진 영양 정보의 단위입니다. |
OpenInfo
비즈니스의 영업 상태와 관련된 정보입니다.
필드 | |
---|---|
status |
위치가 현재 영업 중인지 여부를 나타냅니다. 영업 종료 상태로 업데이트되지 않는 한 기본적으로 모든 위치는 영업 상태입니다. |
can_reopen |
출력 전용. 비즈니스를 재개점할 수 있는지 여부를 나타냅니다. |
opening_date |
위치가 처음 문을 연 날짜입니다. 정확한 날짜를 알 수 없는 경우 월과 연도만 제공될 수 있습니다. 날짜는 과거이거나 1년 이내여야 합니다. |
OpenForBusiness
위치의 상태를 나타냅니다.
열거형 | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
지정되지 않음 |
OPEN |
위치가 영업 중임을 나타냅니다. |
CLOSED_PERMANENTLY |
위치가 폐업 상태임을 나타냅니다. |
CLOSED_TEMPORARILY |
위치가 임시 휴업 상태임을 나타냅니다. 이 값은 게시된 위치에만 적용될 수 있습니다 (예: location_state.is_published = true). 상태 필드를 이 값으로 업데이트할 때 클라이언트는 update_mask 를 명시적으로 open_info.status 로 설정해야 합니다. 이 업데이트 호출 중에는 다른 업데이트 마스크를 설정할 수 없습니다. 이는 일시적인 제한 조치로 곧 완화됩니다. |
PermissionLevel
인증된 사용자가 이 계정에 대해 갖는 액세스 수준을 나타냅니다.
열거형 | |
---|---|
PERMISSION_LEVEL_UNSPECIFIED |
지정되지 않음 |
OWNER_LEVEL |
사용자에게 소유자 수준의 권한이 있습니다. |
MEMBER_LEVEL |
사용자에게 회원 수준 권한이 있습니다. |
PhoneInput
PHONE_CALL/SMS 인증을 위한 입력
필드 | |
---|---|
phone_number |
전화를 걸거나 SMS를 보낼 전화번호입니다. 지원되는 옵션에 있는 전화번호 중 하나여야 합니다. |
PlaceInfo
장소 ID로 표시되는 지역을 정의합니다.
필드 | |
---|---|
name |
장소의 현지화된 이름입니다. |
place_id |
장소의 ID입니다. 리전과 일치해야 합니다. |
Places
장소 집합으로 표시되는 지역의 합집합을 정의합니다.
필드 | |
---|---|
place_infos[] |
장소 ID로 표시되는 지역입니다. 최대 20개 장소로 제한됩니다. |
PointRadius
특정 지점 (위도/경도) 주변의 반경입니다.
필드 | |
---|---|
latlng |
반경으로 정의된 지역의 중심을 지정하는 위도/경도입니다. |
radius_km |
지점 주변 지역의 거리입니다(킬로미터 단위). |
PreparationMethod
음식의 준비 방법입니다.
열거형 | |
---|---|
PREPARATION_METHOD_UNSPECIFIED |
준비 방법 미지정 |
BAKED |
베이킹 메서드 |
BARBECUED |
바비큐 방식 |
BASTED |
배스팅 메서드 |
BLANCHED |
Blanched 메서드 |
BOILED |
끓인 방법 |
BRAISED |
브레이즈 방식 |
CODDLED |
Coddled 메서드 |
FERMENTED |
발효법 |
FRIED |
튀김 요리 |
GRILLED |
그릴 요리 |
KNEADED |
반죽 방식 |
MARINATED |
양념 방법 |
PAN_FRIED |
프라이팬 프라이드 방법 |
PICKLED |
피클 방식 |
PRESSURE_COOKED |
가압 조리 방식 |
ROASTED |
로스팅 방식 |
SAUTEED |
볶기 방법 |
SEARED |
선명하게 넣은 방법 |
SIMMERED |
조림 방법 |
SMOKED |
훈제 방법 |
STEAMED |
찜 방법 |
STEEPED |
스티핑 메서드 |
STIR_FRIED |
볶음 요리법 |
OTHER_METHOD |
기타 방법 |
PriceList
지원 중단됨: 상품 가격 정보 목록입니다. 가격 목록은 1개 이상의 가격 목록으로 구성되며, 각 목록에는 하나 이상의 항목이 포함된 섹션이 하나 이상 포함됩니다. 예를 들어 식품 가격 목록은 버거/스테이크/수산물 섹션이 포함된 아침/점심/저녁 메뉴를 나타낼 수 있습니다.
필드 | |
---|---|
price_list_id |
필수 항목입니다. 가격 목록의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다. |
labels[] |
필수 항목입니다. 언어 태그가 지정된 가격 목록 라벨입니다. |
source_url |
가격 목록을 가져온 소스 URL(선택사항)입니다. 예를 들어 메뉴 정보를 채우기 위해 자동으로 스크랩한 페이지의 URL일 수 있습니다. |
sections[] |
필수 항목입니다. 이 가격 목록의 섹션입니다. 각 가격 목록에는 하나 이상의 섹션이 포함되어야 합니다. |
라벨
가격 목록, 섹션 또는 상품을 표시할 때 사용되는 라벨입니다.
필드 | |
---|---|
display_name |
필수 항목입니다. 가격 목록, 섹션 또는 상품의 표시 이름입니다. |
description |
선택사항입니다. 가격 목록, 섹션 또는 상품의 설명입니다. |
language_code |
선택사항입니다. 이러한 문자열이 적용되는 BCP-47 언어 코드입니다. 언어당 하나의 라벨 집합만 설정할 수 있습니다. |
섹션
하나 이상의 항목을 포함하는 가격 목록 섹션입니다.
필드 | |
---|---|
section_id |
필수 항목입니다. 섹션의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다. |
labels[] |
필수 항목입니다. 언어 태그가 지정된 섹션 라벨입니다. 섹션 이름과 설명은 140자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
section_type |
선택사항입니다. 현재 가격 목록 섹션의 유형입니다. 기본값은 FOOD입니다. |
items[] |
가격 목록의 이 섹션에 포함된 항목입니다. |
항목
단일 목록 항목. 가격 목록에 있는 상품의 각 변형에는 자체 가격 데이터가 있는 자체 상품이 있어야 합니다.
필드 | |
---|---|
item_id |
필수 항목입니다. 상품의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다. |
labels[] |
필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다. |
price |
선택사항입니다. 상품의 가격입니다. |
SectionType
섹션의 유형입니다.
열거형 | |
---|---|
SECTION_TYPE_UNSPECIFIED |
지정되지 않음 |
FOOD |
섹션에 음식을 나타내는 항목이 포함됩니다. |
SERVICES |
섹션에는 서비스를 나타내는 항목이 포함됩니다. |
프로필
위치 프로필과 관련된 모든 정보입니다.
필드 | |
---|---|
description |
본인의 목소리로 위치를 설명하는 것으로, 다른 사람이 수정할 수 없습니다. |
문제
하나의 질문과 그 답변 중 일부를 나타냅니다.
필드 | |
---|---|
name |
출력 전용. 질문의 고유한 이름입니다. accounts/*/locations/*/questions/* |
author |
출력 전용. 질문 작성자입니다. |
upvote_count |
출력 전용. 질문에 대한 찬성 투표 수입니다. |
text |
질문의 텍스트입니다. 단어 3개 이상을 포함해야 하며 총 길이는 10자(영문 기준) 이상이어야 합니다. 최대 길이는 4,096자(영문 기준)입니다. |
create_time |
출력 전용. 질문이 작성된 시간의 타임스탬프입니다. |
update_time |
출력 전용. 질문이 마지막으로 수정된 시간의 타임스탬프입니다. |
top_answers[] |
출력 전용. 질문에 대한 답변 목록으로, 찬성 투표수를 기준으로 정렬됩니다. 요청 매개변수에 따라 이 답변의 전체 목록이 아닐 수도 있습니다 (answers_per_question). |
total_answer_count |
출력 전용. 이 질문에 대해 게시된 총 답변 수입니다. |
RepeatedEnumAttributeValue
value_type
이 REPEATED_ENUM인 속성의 값입니다. 이는 두 가지 값 ID 목록, 즉 설정된 (true) 목록과 설정되지 않은 (false) 목록으로 구성됩니다. 누락된 값은 알 수 없는 것으로 간주됩니다. 값을 1개 이상 지정해야 합니다.
필드 | |
---|---|
set_values[] |
설정된 열거형 값. |
unset_values[] |
설정되지 않은 열거형 값. |
ReportGoogleLocationRequest
GoogleLocation
신고를 위한 요청 메시지입니다.
필드 | ||
---|---|---|
name |
|
|
location_group_name |
선택사항입니다. 이 Google 위치가 보고되는 위치 그룹의 리소스 이름으로 |
|
report_reason_elaboration |
선택사항입니다. 사용자가 이 위치를 신고하는 이유를 자세히 설명하기 위한 텍스트 항목입니다. 최대 길이는 512자(영문 기준)입니다. |
|
report_reason_language_code |
선택사항입니다. |
|
통합 필드 report_reason . 이 위치가 보고되는 이유입니다. 이유를 입력해야 합니다. report_reason 은 다음 중 하나여야 합니다. |
||
report_reason_bad_location |
위치 자체에 문제가 있는 경우 사용자가 이 위치를 신고하는 이유입니다. |
|
report_reason_bad_recommendation |
권장사항과 관련된 문제인 경우 사용자가 이 위치를 신고하는 이유입니다. 이 보고서는 위치가 비즈니스 프로필 계정에 추천된 경우 유용합니다. |
BadLocationReason
위치 자체의 데이터 품질에 문제가 있는 경우 위치를 보고하는 여러 가지 가능한 이유입니다.
열거형 | |
---|---|
BAD_LOCATION_REASON_UNSPECIFIED |
지정되지 않음 |
NOT_A_LOCATION |
추천 위치는 실제 위치가 아닙니다. |
PERMANENTLY_CLOSED |
추천된 위치는 폐업했습니다. |
DOES_NOT_EXIST |
추천 위치가 존재하지 않습니다. |
SPAM |
추천 위치는 스팸, 가짜 위치 또는 불쾌감을 주는 위치입니다. |
NOT_A_BUSINESS |
권장 위치는 비공개 장소 또는 집입니다. |
MOVED |
추천 위치가 새 위치로 이전되었습니다. 새 주소를 지정하는 |
DUPLICATE |
추천 위치가 다른 위치와 중복됩니다. |
BadRecommendationReason
추천 품질에 문제가 있는 경우 (이 위치가 사용자에게 추천된 경우) 위치를 보고하는 여러 가지 이유입니다.
열거형 | |
---|---|
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
지정되지 않음 |
NOT_A_STORE_FRONT |
권장 위치는 상점이 아닙니다. |
NOT_PART_OF_SUGGESTED_CHAIN |
추천 위치가 반환된 위치의 올바른 체인의 이름을 지정하는 |
IRRELEVANT |
추천 위치가 사용자와 관련이 없습니다. 추천이 관련이 없는 이유에 대한 |
ReportLocalPostInsightsRequest
Insights.ReportLocalPostInsights 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 통계를 가져올 위치의 이름입니다. |
local_post_names[] |
필수 항목입니다. 통계 데이터를 가져올 게시물 목록입니다. 모든 게시물은 |
basic_request |
보고서에 기본 측정항목 통계를 포함하도록 요청합니다. 이 요청은 요청한 모든 게시물에 적용됩니다. |
ReportLocalPostInsightsResponse
Insights.ReportLocalPostInsights의 응답 메시지입니다.
필드 | |
---|---|
name |
|
local_post_metrics[] |
이 위치에 해당하는 요청된 게시물당 하나의 항목입니다. |
time_zone |
위치의 시간대입니다 (IANA 시간대 ID, 예: '유럽/런던'). |
ReportLocationInsightsRequest
Insights.ReportLocationInsights 요청 메시지입니다.
필드 | |
---|---|
name |
계정 리소스 이름입니다. |
location_names[] |
통계를 가져올 위치의 모음으로, 이름으로 지정됩니다. |
basic_request |
보고서에 기본 측정항목 통계를 포함하도록 요청합니다. |
driving_directions_request |
보고서에 운전 경로 요청에 대한 통계를 포함해 달라는 요청입니다. |
ReportLocationInsightsResponse
Insights.ReportLocationInsights
의 응답 메시지입니다.
필드 | |
---|---|
location_metrics[] |
위치별 측정항목 값의 모음입니다. |
location_driving_direction_metrics[] |
운전 경로 관련 측정항목의 값 모음입니다. |
검토
출력 전용. 위치의 리뷰를 나타냅니다.
필드 | |
---|---|
name |
리소스 이름입니다. 검토의 경우 |
review_id |
암호화된 고유 식별자입니다. |
reviewer |
리뷰 작성자입니다. |
star_rating |
리뷰의 별표 평점입니다. |
comment |
마크업이 포함된 일반 텍스트인 리뷰 본문입니다. |
create_time |
리뷰가 작성된 시간의 타임스탬프입니다. |
update_time |
리뷰가 마지막으로 수정된 시간의 타임스탬프입니다. |
review_reply |
이 리뷰에 대한 이 위치의 답글의 소유자/관리자입니다. |
리뷰 작성자
리뷰의 작성자를 나타냅니다.
필드 | |
---|---|
profile_photo_url |
리뷰 작성자의 프로필 사진 링크입니다. |
display_name |
리뷰 작성자의 이름입니다. |
is_anonymous |
리뷰 작성자가 익명 유지를 선택했는지 여부를 나타냅니다. |
StarRating
5점 만점 기준의 별표 평점입니다.
열거형 | |
---|---|
STAR_RATING_UNSPECIFIED |
지정되지 않음 |
ONE |
5점 만점 중 별표 평점 1점입니다. |
TWO |
5점 만점 중 별표 평점 2점입니다. |
THREE |
5점 만점 중 별표 평점 3점입니다. |
FOUR |
5점 만점 중 별표 평점 4점입니다. |
FIVE |
최고 별표 평점입니다. |
ReviewReply
리뷰에 대한 위치 소유자/관리자의 답글을 나타냅니다.
필드 | |
---|---|
comment |
마크업이 포함된 일반 텍스트인 답글 본문입니다. 최대 길이는 4,096바이트입니다. |
update_time |
출력 전용. 답글이 마지막으로 수정된 시간의 타임스탬프입니다. |
SearchChainsRequest
Locations.SearchChains의 요청 메시지입니다.
필드 | |
---|---|
chain_display_name |
이름으로 체인을 검색합니다. 완전/부분적/퍼지/관련 쿼리가 지원됩니다. 예: 'walmart', 'wal-mart', 'walmmmart', '沃尔玛' |
result_count |
이 쿼리에서 반환할 일치하는 체인의 최대 개수입니다. 기본값은 10입니다. 가능한 최댓값은 500입니다. |
SearchChainsResponse
Locations.SearchChains의 응답 메시지입니다.
필드 | |
---|---|
chains[] |
SearchChainsRequest에서 쿼리된 Chain_display_name과 일치하는 체인입니다. 일치하는 항목이 없으면 이 필드는 비어 있습니다. 결과는 관련성 순으로 나열됩니다. |
SearchGoogleLocationsRequest
GoogleLocations.SearchGoogleLocations 요청 메시지입니다.
필드 | ||
---|---|---|
result_count |
반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청하면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기 기능이 없습니다. |
|
통합 필드 search_query . 검색어입니다. 위치 객체 또는 문자열 쿼리로 제공될 수 있습니다. search_query 은 다음 중 하나여야 합니다. |
||
location |
검색할 위치입니다. 제공된 경우 제공된 위치 세부정보와 일치하는 위치를 찾습니다. |
|
query |
검색할 텍스트 쿼리입니다. 쿼리 문자열의 검색결과는 정확한 위치를 제공하는 경우보다 정확도가 떨어질 수 있지만 부정확한 일치는 더 많이 제공될 수 있습니다. |
SearchGoogleLocationsResponse
GoogleLocations.SearchGoogleLocations의 응답 메시지입니다.
필드 | |
---|---|
google_locations[] |
지정된 요청과 일치할 가능성이 있는 GoogleLocations 모음으로, 정확성이 높은 것부터 낮은 순으로 나열됩니다. |
ServiceAreaBusiness
방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다 (예: 열쇠공 또는 배관공).
필드 | ||
---|---|---|
business_type |
방문 서비스 업체의 |
|
통합 필드 coverageArea . 비즈니스가 서비스를 제공하는 범위를 나타냅니다. coverageArea 은 다음 중 하나여야 합니다. |
||
radius |
출력 전용. 이 비즈니스가 서비스를 제공하는 지역이 특정 지점을 중심으로 합니다. |
|
places |
이 비즈니스가 서비스를 제공하는 지역이 장소의 집합을 통해 정의됩니다. |
BusinessType
이 비즈니스가 고객 위치에서 현장 서비스만 제공하는지 (예: 견인 트럭) 주소와 현장 모두에서 서비스를 제공하는지 (예: 고객에게 배달도 하고 식사 공간이 있는 피자 가게)를 나타냅니다.
열거형 | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
출력 전용. 지정되지 않음 |
CUSTOMER_LOCATION_ONLY |
주변 지역 (비즈니스 주소가 아닌)에서만 서비스를 제공합니다. |
CUSTOMER_AND_BUSINESS_LOCATION |
비즈니스 주소 및 주변 지역에서 서비스를 제공합니다. |
ServiceBusinessContext
서비스 비즈니스 인증을 위한 추가 데이터입니다.
필드 | |
---|---|
address |
위치의 인증 주소입니다. 인증 옵션을 더 사용하거나 엽서를 보내는 데 사용됩니다. |
ServiceList
하나 이상의 서비스 항목이 포함된 서비스 목록입니다.
필드 | |
---|---|
name |
필수 항목입니다. 이 위치의 Google 식별자(형식: |
service_items[] |
이 서비스 목록에 포함된 서비스 항목입니다. 중복된 서비스 항목은 자동으로 삭제됩니다. |
ServiceItem
단일 서비스 항목을 설명하는 메시지입니다. 판매자가 제공하는 서비스 유형을 설명하는 데 사용됩니다. 예를 들어 이발은 서비스가 될 수 있습니다.
필드 | ||
---|---|---|
is_offered |
선택사항입니다. 이 필드는 판매자가 입력 서비스를 제공하는지 여부를 결정합니다. |
|
price |
선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 currency_code 및 단위를 설정하는 것이 좋습니다. |
|
통합 필드 service_item_info . 다음 필드 중 하나를 항상 설정해야 합니다. service_item_info 은 다음 중 하나여야 합니다. |
||
structured_service_item |
이 필드는 구조화된 서비스 데이터의 케이스로 설정됩니다. |
|
free_form_service_item |
이 필드는 자유 형식 서비스 데이터의 경우로 설정됩니다. |
FreeFormServiceItem
판매자가 제공하는 자유 형식의 서비스를 나타냅니다. Google 구조 서비스 데이터의 일부로 노출되지 않는 서비스입니다. 판매자는 지오판매자 표시 경로를 통해 이러한 서비스의 이름을 직접 입력합니다.
필드 | |
---|---|
category_id |
필수 항목입니다. |
label |
필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 이 필드는 입력이 맞춤 서비스 항목인 경우에만 설정해야 합니다. 표준화된 서비스 유형은 service_type_id를 통해 업데이트해야 합니다. |
StructuredServiceItem
판매자가 제공하는 구조화된 서비스를 나타냅니다. 예: toilet_installation
필드 | |
---|---|
service_type_id |
필수 항목입니다. |
description |
선택사항입니다. 구조화된 서비스 항목에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다. |
ServiceType
비즈니스에서 제공하는 서비스 유형을 설명하는 메시지입니다.
필드 | |
---|---|
service_type_id |
출력 전용. 이 서비스 유형의 안정적인 ID입니다 (Google에서 제공). |
display_name |
출력 전용. 사람이 읽을 수 있는 서비스 유형의 표시 이름입니다. |
SpecialHourPeriod
위치의 영업시간이 정상 영업시간과 다른 경우 단일 기간을 나타냅니다. 특별 영업시간에 표시되는 범위는 24시간 미만이어야 합니다. open_time
및 start_date
는 close_time
및 end_date
보다 이전이어야 합니다. close_time
및 end_date
는 지정된 start_date
다음 날 오전 11시 59분까지 연장할 수 있습니다. 예를 들어 다음 입력은 유효합니다.
start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59
다음 입력은 유효하지 않습니다.
start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
필드 | |
---|---|
start_date |
특별 영업시간 기간이 시작되는 캘린더 날짜입니다. |
open_time |
위치가 개장하는 |
end_date |
특별 영업시간 기간이 종료되는 캘린더 날짜입니다. |
close_time |
위치가 폐업할 때 |
is_closed |
true인 경우 |
SpecialHours
위치의 영업시간이 정상 영업시간과 다른 기간 집합을 나타냅니다.
필드 | |
---|---|
special_hour_periods[] |
비즈니스의 정규 영업시간에 대한 예외 목록입니다. |
매운 정도
식품의 매운 정도입니다.
열거형 | |
---|---|
SPICINESS_UNSPECIFIED |
등급 미지정 |
MILD |
부드러운 매운맛을 나타냅니다. |
MEDIUM |
약간 매운맛의 표시입니다. |
HOT |
매운 매운의 표시입니다. 가장 매끄러운 수준입니다. |
StartUploadMediaItemDataRequest
Media.StartUploadMediaItemData 요청 메시지입니다.
필드 | |
---|---|
parent |
이 미디어 항목이 추가될 위치의 리소스 이름입니다. |
TimeInterval
시간 간격입니다(해당 값 포함). 유효하려면 모든 필드가 포함되어야 합니다.
필드 | |
---|---|
start_date |
이 기간의 시작일입니다. |
start_time |
이 기간의 시작 시간입니다. |
end_date |
이 기간의 종료일입니다. |
end_time |
이 기간의 종료 시간입니다. |
TimePeriod
지정된 개장 날짜/시간에 시작해 지정된 종료 날짜/시간에 종료하는 비즈니스의 영업 기간을 나타냅니다. 영업 종료 시간은 시작 시간 뒤(예: 같은 날 이후 시간 또는 이후 날짜)에 와야 합니다.
필드 | |
---|---|
open_day |
이 기간이 시작되는 |
open_time |
24시간 ISO 8601 확장 형식 (hh:mm) 시간입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. |
close_day |
이 기간이 끝나는 |
close_time |
24시간 ISO 8601 확장 형식 (hh:mm) 시간입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. |
TimeRange
시간 범위입니다. 데이터는 범위 내에서 반개방 정수([start_time, end_time)]로 가져옵니다.
필드 | |
---|---|
start_time |
범위 시작 (해당 값 포함)의 에포크 타임스탬프입니다. |
end_time |
범위 끝의 에포크 타임스탬프입니다 (제외). |
TransferLocationRequest
Locations.TransferLocation 요청 메시지입니다.
필드 | |
---|---|
name |
이전할 위치의 이름입니다. |
to_account |
위치를 이전할 계정 리소스의 이름입니다 (예: 'accounts/8675309'). |
UpdateAccountAdminRequest
AccessControl.UpdateAccountAdmin 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 관리자의 리소스 이름입니다. |
admin |
업데이트된 관리자입니다. 참고: 수정할 수 있는 필드는 |
UpdateAccountRequest
Accounts.UpdateAccount에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 계정의 이름입니다. |
account |
업데이트된 계정 정보입니다. 참고: 수정할 수 있는 필드는 |
validate_only |
true인 경우 실제로 계정을 업데이트하지 않고 요청의 유효성이 검사됩니다. |
UpdateFoodMenusRequest
FoodMenu.UpdateFoodMenus 요청 메시지입니다.
필드 | |
---|---|
food_menus |
필수 항목입니다. 업데이트된 음식 메뉴 정보입니다. 메뉴 섹션 없이 업데이트하여 메뉴를 설정 해제할 수 있습니다. |
update_mask |
선택사항입니다. 업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. 반복되는 입력란 항목은 개별적으로 업데이트할 수 없습니다. 참고: FoodMenus의 'name'은 업데이트할 수 없는 리소스 식별자입니다. |
UpdateHealthProviderAttributesRequest
HealthProviderAttributes.UpdateHealthProviderAttributes 요청 메시지입니다.
필드 | |
---|---|
health_provider_attributes |
필수 항목입니다. 업데이트된 의료인 속성 |
update_mask |
선택사항입니다. 업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. V1에는 업데이트할 assured_networks 필드만 있습니다. 나중에 더 많은 속성이 지원될 예정입니다. |
UpdateLocalPostRequest
UpdateLocalPost 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 지역 게시물의 이름입니다. |
local_post |
업데이트된 지역 게시물 정보입니다. |
update_mask |
업데이트할 특정 필드입니다. 마스크에서 업데이트 중인 각 필드를 지정해야 합니다. |
UpdateLocationAdminRequest
AccessControl.UpdateLocationAdmin 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 관리자의 리소스 이름입니다. |
admin |
업데이트된 관리자입니다. 참고: 수정할 수 있는 필드는 |
UpdateLocationRequest
Locations.UpdateLocation 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 위치의 이름입니다. |
location |
업데이트된 위치 정보입니다. |
update_mask |
업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. |
validate_only |
true인 경우 실제로 위치를 업데이트하지 않고 요청의 유효성이 검사됩니다. |
attribute_mask |
업데이트할 속성의 ID입니다. 마스크에 명시된 속성만 업데이트됩니다. 마스크에는 있고 위치에는 없는 속성은 삭제됩니다. 마스크가 비어 있으면 모든 속성이 업데이트됩니다. 이 필드가 설정될 때마다 update_mask는 업데이트할 필드 중 하나로 속성을 포함해야 합니다. |
UpdateMediaItemRequest
Media.UpdateMediaItem 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 미디어 항목의 이름입니다. |
media_item |
업데이트할 미디어 항목입니다. 카테고리 또는 가격 목록 항목 ID만 업데이트할 수 있습니다. |
update_mask |
업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 수정 가능한 필드가 전달된 값으로 설정됩니다. |
UpdateNotificationsRequest
Accounts.UpdateNotifications 요청 메시지입니다.
필드 | |
---|---|
name |
알림 설정 리소스 이름입니다. |
notifications |
업데이트된 알림 설정 |
UpdateQuestionRequest
QuestionsAndAnswers.UpdateQuestion 요청 메시지입니다.
필드 | |
---|---|
name |
업데이트할 질문의 이름입니다. |
question |
업데이트된 질문입니다. |
UpdateReviewReplyRequest
Reviews.UpdateReviewReply 요청 메시지입니다.
필드 | |
---|---|
name |
답글을 달 리뷰의 이름입니다. |
review_reply |
리뷰에 대한 답글입니다. 이미 답글이 있는 경우 이전 답글을 대체합니다. |
UpdateServiceListRequest
서비스 목록 업데이트 요청 메시지입니다.
필드 | |
---|---|
service_list |
선택사항입니다. 업데이트된 서비스 목록 정보입니다. 이 필드를 비워 두면 API가 ServiceList를 삭제합니다. ServiceList가 설정된 경우 API는 원래 ServiceList를 설정된 서비스로 대체합니다. |
update_mask |
선택사항입니다. 업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. 반복되는 입력란 항목은 개별적으로 업데이트할 수 없습니다. |
UpsertAnswerRequest
QuestionsAndAnswers.UpsertAnswer 요청 메시지입니다.
필드 | |
---|---|
parent |
답변을 작성할 질문의 이름입니다. |
answer |
새로운 답변 |
UrlAttributeValue
URL이 value_type
인 속성 값입니다.
필드 | |
---|---|
url |
URL입니다. |
ValidationError
클라이언트 요청의 유효성 검사 실패를 설명합니다.
필드 | |
---|---|
error_details[] |
정수 오류 코드가 있는 개별 유효성 검사 실패를 자세히 설명합니다. |
인증
인증은 위치에 대한 인증 시도를 나타냅니다.
필드 | |
---|---|
name |
인증의 리소스 이름입니다. |
method |
확인 방법입니다. |
state |
인증 상태입니다. |
create_time |
인증이 요청된 시점의 타임스탬프입니다. |
VerificationState
가능한 모든 확인 상태입니다.
열거형 | |
---|---|
VERIFICATION_STATE_UNSPECIFIED |
기본값으로 사용하면 오류가 발생합니다. |
PENDING |
인증이 대기 중입니다. |
COMPLETED |
인증이 완료되었습니다. |
FAILED |
인증에 실패했습니다. |
VerificationMethod
Google에서 위치를 인증하는 데 사용하는 프로세스를 지정합니다.
열거형 | |
---|---|
VERIFICATION_METHOD_UNSPECIFIED |
기본값으로 사용하면 오류가 발생합니다. |
ADDRESS |
인증 PIN이 포함된 엽서를 특정 우편 주소로 보내세요. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
EMAIL |
특정 이메일 주소로 인증 PIN이 포함된 이메일을 보내세요. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
PHONE_CALL |
특정 전화번호로 인증 PIN을 사용하여 전화를 겁니다. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
SMS |
특정 전화번호로 인증 PIN이 포함된 SMS를 보내세요. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
AUTO |
추가적인 사용자 작업 없이 위치를 인증합니다. 일부 지역에서는 이 옵션을 사용하지 못할 수도 있습니다. |
VerificationOption
인증 옵션은 위치를 확인하는 방법 (인증 방법으로 표시) 및 인증이 전송될 위치 (표시 데이터로 표시)를 나타냅니다.
필드 | ||
---|---|---|
verification_method |
위치를 확인하는 메서드입니다. |
|
통합 필드 DisplayData . 디스플레이 데이터 중 하나입니다. 데이터가 메서드와 일치해야 합니다. 상응하는 메서드에 표시 데이터가 없으면 비어 있습니다. DisplayData 은 다음 중 하나여야 합니다. |
||
phone_data |
메서드가 PHONE_CALL 또는 SMS인 경우에만 설정합니다. |
|
address_data |
메서드가 메일인 경우에만 설정합니다. |
|
email_data |
메서드가 EMAIL인 경우에만 설정합니다. |
AddressVerificationData
엽서를 통해 인증을 위한 데이터를 표시합니다.
필드 | |
---|---|
business_name |
판매자의 업체 이름입니다. |
address |
엽서를 받을 수 있는 주소입니다. |
EmailVerificationData
이메일을 통한 인증을 위한 데이터를 표시합니다.
필드 | |
---|---|
domain_name |
이메일 주소에 도메인 이름(예: foo@gmail.com의 'gmail.com') |
user_name |
이메일 주소의 사용자 이름(예: foo@gmail.com의 'foo') |
is_user_name_editable |
클라이언트가 다른 사용자 이름을 제공할 수 있는지 여부입니다. |
PhoneVerificationData
전화 통화, SMS 등 전화를 통한 인증을 위한 데이터 표시
필드 | |
---|---|
phone_number |
PIN을 받을 전화번호입니다. |
VerifyLocationRequest
Verifications.VerifyLocation 요청 메시지입니다.
필드 | ||
---|---|---|
name |
확인할 위치의 리소스 이름입니다. |
|
method |
확인 방법입니다. |
|
language_code |
인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다. |
|
context |
서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에 필수입니다. ADDRESS 인증의 경우 엽서를 발송할 때 주소가 사용됩니다. 다른 메서드의 경우 FetchVerificationOptions에 전달되는 것과 동일해야 합니다. INVALID_ 이는 다른 유형의 업체 위치에 대해 설정된 경우 발생합니다. |
|
통합 필드 RequestData . 표시 데이터 외에 특정 방식에 대한 사용자 입력 데이터입니다. 데이터가 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. RequestData 은 다음 중 하나여야 합니다. |
||
email_input |
EMAIL 방법에 대한 입력입니다. |
|
address_input |
ADDRESS 메서드의 입력입니다. |
|
phone_input |
PHONE_CALL/SMS 메서드에 대한 입력 |
VerifyLocationResponse
Verifications.VerifyLocation의 응답 메시지입니다.
필드 | |
---|---|
verification |
생성된 인증 요청 |