Package google.mybusiness.v4

색인

AccessControl

이 서비스를 사용하면 계정 및 위치에 액세스할 수 있는 사용자를 관리할 수 있습니다.

AcceptInvitation

rpc AcceptInvitation(AcceptInvitationRequest) returns (Empty)

지정된 초대를 수락합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CreateAccountAdmin

rpc CreateAccountAdmin(CreateAccountAdminRequest) returns (Admin)

지정된 사용자를 지정된 계정의 관리자로 초대합니다. 초대를 받은 사용자가 초대를 수락해야 계정에 대한 액세스 권한이 부여됩니다. 프로그래매틱 방식으로 초대를 수락하려면 [AcceptInvitation] [google.mybusiness.v4.AcceptInvitation] 을 참조하세요.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CreateLocationAdmin

rpc CreateLocationAdmin(CreateLocationAdminRequest) returns (Admin)

지정된 사용자를 지정된 위치의 관리자로 초대합니다. 초대를 받은 사용자가 초대를 수락해야 위치에 대한 액세스 권한이 부여됩니다. 프로그래매틱 방식으로 초대를 수락하려면 [AcceptInvitation] [google.mybusiness.v4.AcceptInvitation] 을 참조하세요.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeclineInvitation

rpc DeclineInvitation(DeclineInvitationRequest) returns (Empty)

지정된 초대를 거부합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteAccountAdmin

rpc DeleteAccountAdmin(DeleteAccountAdminRequest) returns (Empty)

지정된 계정에서 지정된 관리자를 삭제합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteLocationAdmin

rpc DeleteLocationAdmin(DeleteLocationAdminRequest) returns (Empty)

지정된 위치의 관리자로 지정된 관리자를 삭제합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListAccountAdmins

rpc ListAccountAdmins(ListAccountAdminsRequest) returns (ListAccountAdminsResponse)

지정된 계정의 관리자를 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListInvitations

rpc ListInvitations(ListInvitationsRequest) returns (ListInvitationsResponse)

지정된 계정의 대기 중인 초대를 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListLocationAdmins

rpc ListLocationAdmins(ListLocationAdminsRequest) returns (ListLocationAdminsResponse)

지정된 위치의 모든 관리자를 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateAccountAdmin

rpc UpdateAccountAdmin(UpdateAccountAdminRequest) returns (Admin)

지정된 계정 관리자의 관리자를 업데이트합니다. 관리자의 AdminRole만 업데이트할 수 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateLocationAdmin

rpc UpdateLocationAdmin(UpdateLocationAdminRequest) returns (Admin)

지정된 위치 관리자의 관리자를 업데이트합니다. 관리자의 AdminRole만 업데이트할 수 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

계정

이 API를 사용하면 Google에서 비즈니스 계정을 관리할 수 있습니다. 이를 통해 Account 리소스를 관리할 수 있습니다. 이 클래스는 다음과 같은 리소스 모델을 정의합니다.

  • API에는 accounts/*라는 Account 리소스 컬렉션이 있습니다.

  • 편의상 인증된 발신자의 개인 계정에 대한 계정 ID 대신 동의어 'me'를 사용할 수도 있습니다. 예: GET /v4/accounts/me GET /v4/accounts/me/locations

CreateAccount

rpc CreateAccount(CreateAccountRequest) returns (Account)

지정된 상위 항목에 지정된 이름과 유형의 계정을 만듭니다.

  • 개인 계정과 조직은 만들 수 없습니다.
  • 기본 소유자로 개인 계정을 사용하여 사용자 그룹을 만들 수 없습니다.
  • 개인 계정이 조직에 속한 경우 개인 계정의 기본 소유자로 위치 그룹을 만들 수 없습니다.
  • 위치 그룹은 위치 그룹을 소유할 수 없습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteNotifications

rpc DeleteNotifications(DeleteNotificationsRequest) returns (Empty)

계정의 Pub/Sub 알림 설정을 지웁니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GenerateAccountNumber

rpc GenerateAccountNumber(GenerateAccountNumberRequest) returns (Account)

이 계정의 계좌 번호를 생성합니다. 계정을 만들 때 계좌 번호가 프로비저닝되지 않습니다. 필요한 경우 이 요청을 사용하여 계좌 번호를 만듭니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

지정된 계정을 가져옵니다. 계정이 없거나 호출자에게 계정 액세스 권한이 없는 경우 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetNotifications

rpc GetNotifications(GetNotificationsRequest) returns (Notifications)

계정의 Pub/Sub 알림 설정을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

인증된 사용자의 모든 계정을 나열합니다. 여기에는 사용자가 소유한 모든 계정과 사용자가 관리 권한을 보유한 계정이 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

지정된 비즈니스 계정을 업데이트합니다. 이 방법으로는 개인 계정을 업데이트할 수 없습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateNotifications

rpc UpdateNotifications(UpdateNotificationsRequest) returns (Notifications)

비즈니스 프로필에 Pub/Sub 알림을 보낼 주제를 알리는 계정의 Pub/Sub 알림 설정을 설정합니다.

  • 계정에서 관리하는 위치에 대한 새 리뷰
  • 계정에서 관리하는 위치에 대한 리뷰가 업데이트되었습니다.
  • 계정에서 관리하는 위치에 대한 새 GoogleUpdates.

계정에는 하나의 알림 설정 리소스만 있으며 Pub/Sub 주제는 1개만 설정할 수 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

BusinessCategories

이 API를 사용하면 Google에서 비즈니스 위치에 대해 지원되는 카테고리를 볼 수 있습니다. 사용 가능한 모든 비즈니스 카테고리의 페이지로 나눈 목록을 가져오거나 특정 검색어로 검색할 수 있습니다. 자세한 내용은 이 도움말의 카테고리 섹션을 참조하세요. https://support.google.com/business/answer/3038177

BatchGetBusinessCategories

rpc BatchGetBusinessCategories(BatchGetBusinessCategoriesRequest) returns (BatchGetBusinessCategoriesResponse)

제공된 언어 및 GConcept ID에 대한 비즈니스 카테고리 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListBusinessCategories

rpc ListBusinessCategories(ListBusinessCategoriesRequest) returns (ListBusinessCategoriesResponse)

비즈니스 카테고리의 목록을 반환합니다. 검색은 카테고리 이름과 일치하지만 카테고리 ID와는 일치하지 않습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

BusinessMessagingService

비즈니스가 비즈니스 메시지를 위해 위치를 등록하여 위치를 검색하는 소비자의 커뮤니케이션 채널을 활용할 수 있습니다. 위치의 비즈니스 메시지를 보고 작업을 실행하려면 위치의 MANAGER 또는 OWNER여야 합니다.

팔로어

이 API는 팔로어의 관리 API를 노출합니다.

GetFollowersMetadata

rpc GetFollowersMetadata(GetFollowersMetadataRequest) returns (FollowersMetadata)

위치의 팔로어 설정을 가져옵니다.

계정 또는 위치가 존재하지 않는 경우 NOT_FOUND가 반환됩니다. 위치가 인증되지 않거나 지도에 연결되지 않은 경우 PRECONDITION_FAILED가 반환됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

FoodMenuService

이 API를 사용하면 업체 위치의 음식 메뉴를 가져오고 업데이트할 수 있습니다.

Location.PriceList는 또한 유형 중 하나로 '메뉴'를 나타내지만 제한된 필드를 사용합니다. FoodMenus와 동일한 다운스트림 스토리지를 공유합니다. FoodMenuService로 이전이 완료되면 클라이언트는 예기치 않은 데이터 손실을 초래할 수 있으므로 메뉴 데이터를 업데이트하는 데 Location.PriceList를 더 이상 사용하지 않는 것이 좋습니다.

GetFoodMenus

rpc GetFoodMenus(GetFoodMenusRequest) returns (FoodMenus)

특정 위치의 음식 메뉴를 반환합니다. location.location_state.can_have_food_menu가 true인 경우에만 호출합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateFoodMenus

rpc UpdateFoodMenus(UpdateFoodMenusRequest) returns (FoodMenus)

특정 위치의 음식 메뉴를 업데이트합니다. location.location_state.can_have_food_menu가 true인 경우에만 호출합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GoogleLocations

이 API를 사용하면 GoogleLocation에 액세스하고 검색할 수 있습니다.

ListRecommendedGoogleLocations

rpc ListRecommendedGoogleLocations(ListRecommendedGoogleLocationsRequest) returns (ListRecommendedGoogleLocationsResponse)

지정된 비즈니스 프로필 계정에 추천된 모든 GoogleLocation를 나열합니다. 추천은 개인 계정 및 위치 그룹에만 제공되며, 기타 모든 계정 유형에 대해 요청하면 오류가 발생합니다. 위치 그룹에 대한 추천은 해당 그룹의 위치를 기반으로 합니다.

개인 계정을 위한 추천은 사용자가 비즈니스 프로필에서 액세스할 수 있는 모든 위치 (위치 그룹을 통해 액세스할 수 있는 위치 포함)를 기반으로 하며 사용자를 위해 생성된 모든 추천의 상위 집합입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ReportGoogleLocation

rpc ReportGoogleLocation(ReportGoogleLocationRequest) returns (Empty)

GoogleLocation을 신고하세요.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

지정된 요청과 일치하는 가능한 모든 위치를 검색합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

HealthProviderAttributesService

이 서비스를 사용하면 위치와 연결된 의료인 속성 (예: 위치에서 허용되는 보험)을 관리할 수 있습니다.

GetHealthProviderAttributes

rpc GetHealthProviderAttributes(GetHealthProviderAttributesRequest) returns (HealthProviderAttributes)

특정 위치의 의료인 속성을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateHealthProviderAttributes

rpc UpdateHealthProviderAttributes(UpdateHealthProviderAttributesRequest) returns (HealthProviderAttributes)

특정 위치의 의료인 속성을 업데이트합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

유용한 정보

Google 서비스에서 하나 이상의 비즈니스 정보에 대한 소비자 통계를 자세히 설명하는 보고서를 생성합니다. 기본 측정항목의 집계된 데이터는 최대 18개월의 기간에 걸쳐 쿼리할 수 있습니다. 분석을 지원하는 측정항목은 이 기간에 대해 집계된 데이터를 요일 또는 시간별로 세분화하여 표시할 수 있습니다. 운전 경로 요청을 선택한 기간 동안 스냅샷으로 보고할 수 있습니다.

ReportLocalPostInsights

rpc ReportLocalPostInsights(ReportLocalPostInsightsRequest) returns (ReportLocalPostInsightsResponse)

단일 비즈니스 정보에 연결된 지역 게시물 집합의 통계를 반환합니다. 어떤 측정항목과 보고 방식이 요청 프로토콜에 지정된 옵션입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ReportLocationInsights

rpc ReportLocationInsights(ReportLocationInsightsRequest) returns (ReportLocationInsightsResponse)

위치별 측정항목 하나 이상의 통계가 포함된 보고서를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

InsuranceNetworkService

이 서비스를 사용하면 Google에서 의료 업체 위치에 대해 지원되는 모든 보험 네트워크를 가져올 수 있습니다.

ListInsuranceNetworks

rpc ListInsuranceNetworks(ListInsuranceNetworksRequest) returns (ListInsuranceNetworksResponse)

Google에서 지원하는 모든 보험 네트워크의 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

LocalPosts

이 API는 지역 게시물의 관리 API를 노출합니다.

CreateLocalPost

rpc CreateLocalPost(CreateLocalPostRequest) returns (LocalPost)

지정된 위치와 연결된 새 지역 게시물을 만들어 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteLocalPost

rpc DeleteLocalPost(DeleteLocalPostRequest) returns (Empty)

지역 게시물을 삭제합니다. 지역 게시물이 없으면 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetLocalPost

rpc GetLocalPost(GetLocalPostRequest) returns (LocalPost)

지정된 지역 게시물을 가져옵니다. 지역 게시물이 없으면 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListLocalPosts

rpc ListLocalPosts(ListLocalPostsRequest) returns (ListLocalPostsResponse)

위치와 연결된 지역 게시물 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateLocalPost

rpc UpdateLocalPost(UpdateLocalPostRequest) returns (LocalPost)

지정된 지역 게시물을 업데이트하고 업데이트된 지역 게시물을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

위치

이 API를 사용하면 Google에서 업체 위치를 관리할 수 있습니다. 이를 통해 Location 리소스를 관리할 수 있습니다. 이 클래스는 다음과 같은 리소스 모델을 정의합니다.

  • API에는 accounts/*라는 Account 리소스 컬렉션이 있습니다.

  • 편의상 인증된 발신자의 개인 계정에 대한 계정 ID 대신 동의어 'me'를 사용할 수도 있습니다. 예: GET /v4/accounts/me GET /v4/accounts/me/locations

  • Account에는 accounts/*/locations/*라는 Location 리소스 컬렉션이 있습니다.

AssociateLocation

rpc AssociateLocation(AssociateLocationRequest) returns (Empty)

위치를 장소 ID에 연결합니다. 이전 연결은 모두 덮어씁니다. 이 작업은 위치가 인증되지 않은 경우에만 유효합니다. 연결이 유효해야 합니다. 즉, FindMatchingLocations 목록에 표시됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

BatchGetLocations

rpc BatchGetLocations(BatchGetLocationsRequest) returns (BatchGetLocationsResponse)

지정된 계정에서 지정된 모든 위치를 가져옵니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ClearLocationAssociation

rpc ClearLocationAssociation(ClearLocationAssociationRequest) returns (Empty)

위치와 장소 ID 간의 연결을 삭제합니다. 이 작업은 위치가 인증되지 않은 경우에만 유효합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

지정된 계정이 소유한 새 location를 만들어 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

위치를 삭제합니다.

FindMatchingLocations

rpc FindMatchingLocations(FindMatchingLocationsRequest) returns (FindMatchingLocationsResponse)

지정된 위치와 일치하는 가능한 모든 위치를 찾습니다. 이 작업은 위치가 인증되지 않은 경우에만 유효합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

지정된 체인을 가져옵니다. 체인이 없으면 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetLocationRequest) returns (GoogleUpdatedLocation)

지정된 위치의 Google 업데이트 버전을 가져옵니다. 위치가 없는 경우 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

지정된 위치를 가져옵니다. 위치가 없는 경우 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

지정된 기본 카테고리 및 국가가 있는 위치에 사용할 수 있는 속성 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

지정된 계정의 위치를 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

체인 이름을 기준으로 체인을 검색합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

TransferLocation

rpc TransferLocation(TransferLocationRequest) returns (Location)

사용자가 소유한 계정에서 동일한 사용자가 관리하는 다른 계정으로 위치를 이동합니다. 사용자는 위치가 현재 연결된 계정의 소유자여야 하며, 대상 계정의 관리자 이상이어야 합니다. 위치를 새 리소스 이름으로 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

지정된 위치를 업데이트합니다.

사진은 Google+ 페이지가 있는 위치에만 허용됩니다.

위치가 없는 경우 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

미디어

이 서비스를 사용하면 위치에 연결된 미디어 (사진 및 동영상)를 관리할 수 있습니다.

CreateMediaItem

rpc CreateMediaItem(CreateMediaItemRequest) returns (MediaItem)

위치에 대한 새 미디어 항목을 만듭니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteMediaItem

rpc DeleteMediaItem(DeleteMediaItemRequest) returns (Empty)

지정된 미디어 항목을 삭제합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetCustomerMediaItem

rpc GetCustomerMediaItem(GetCustomerMediaItemRequest) returns (MediaItem)

요청된 고객 미디어 항목의 메타데이터를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetMediaItem

rpc GetMediaItem(GetMediaItemRequest) returns (MediaItem)

요청된 미디어 항목의 메타데이터를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListCustomerMediaItems

rpc ListCustomerMediaItems(ListCustomerMediaItemsRequest) returns (ListCustomerMediaItemsResponse)

고객이 제공한 위치와 연결된 미디어 항목의 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListMediaItems

rpc ListMediaItems(ListMediaItemsRequest) returns (ListMediaItemsResponse)

위치와 연결된 미디어 항목의 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

StartUploadMediaItemData

rpc StartUploadMediaItemData(StartUploadMediaItemDataRequest) returns (MediaItemDataRef)

미디어 항목 업로드를 위한 MediaItemDataRef를 생성합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateMediaItem

rpc UpdateMediaItem(UpdateMediaItemRequest) returns (MediaItem)

지정된 미디어 항목의 메타데이터를 업데이트합니다. 미디어 항목의 카테고리를 업데이트하는 데만 사용할 수 있습니다. 단, 새 카테고리는 COVER 또는 PROFILE일 수 없습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

QuestionsAndAnswers

이 서비스를 사용하여 위치에 대한 질문과 답변을 관리할 수 있습니다. 질문 및 답변 작업은 인증된 위치에서만 유효합니다.

CreateQuestion

rpc CreateQuestion(CreateQuestionRequest) returns (Question)

지정된 위치에 대한 질문을 추가합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteAnswer

rpc DeleteAnswer(DeleteAnswerRequest) returns (Empty)

현재 사용자가 질문에 작성한 답변을 삭제합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteQuestion

rpc DeleteQuestion(DeleteQuestionRequest) returns (Empty)

현재 사용자가 작성한 특정 질문을 삭제합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListAnswers

rpc ListAnswers(ListAnswersRequest) returns (ListAnswersResponse)

지정된 질문에 대해 페이지로 나눈 답변 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListQuestions

rpc ListQuestions(ListQuestionsRequest) returns (ListQuestionsResponse)

지정된 위치에 대해 페이지로 나눈 질문 목록과 일부 답변을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateQuestion

rpc UpdateQuestion(UpdateQuestionRequest) returns (Question)

현재 사용자가 작성한 특정 질문을 업데이트합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpsertAnswer

rpc UpsertAnswer(UpsertAnswerRequest) returns (Answer)

지정된 질문에 대해 답변을 만들거나 사용자가 작성한 기존 답변을 업데이트합니다. 사용자는 질문당 하나의 답변만 만들 수 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

리뷰

이 API는 리뷰에 대한 CRUD 작업을 제공합니다. google.mybusiness.v4.Reviews.

BatchGetReviews

rpc BatchGetReviews(BatchGetReviewsRequest) returns (BatchGetReviewsResponse)

지정된 모든 위치의 페이지로 나눈 리뷰 목록을 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteReviewReply

rpc DeleteReviewReply(DeleteReviewReplyRequest) returns (Empty)

지정된 리뷰에 대한 답글을 삭제합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetReview

rpc GetReview(GetReviewRequest) returns (Review)

지정된 리뷰를 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다. 리뷰가 없거나 삭제된 경우 NOT_FOUND를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListReviews

rpc ListReviews(ListReviewsRequest) returns (ListReviewsResponse)

지정된 위치의 페이지로 나눈 리뷰 목록을 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateReviewReply

rpc UpdateReviewReply(UpdateReviewReplyRequest) returns (ReviewReply)

지정된 리뷰에 대한 답글을 업데이트합니다. 답글이 없으면 답글이 생성됩니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ServiceLists

이 API를 사용하면 Google에서 업체 위치의 서비스 목록을 가져오고 업데이트할 수 있습니다. 서비스 목록에는 판매자가 제공하는 서비스 항목 목록이 포함됩니다. 이발, 온수기 설치 등의 서비스가 제공될 수 있습니다.

GetServiceList

rpc GetServiceList(GetServiceListRequest) returns (ServiceList)

위치의 지정된 서비스 목록을 가져옵니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateServiceList

rpc UpdateServiceList(UpdateServiceListRequest) returns (ServiceList)

위치의 지정된 서비스 목록을 업데이트합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

인증

이 API를 사용하면 Google에서의 위치 인증을 관리할 수 있습니다. 이를 통해 Verification 리소스를 관리할 수 있습니다.

Location에는 accounts/*/locations/*/verifications/*라는 Verification 리소스 컬렉션이 있습니다.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

PENDING 인증을 완료합니다.

AUTO이 아닌 인증 방법에만 필요합니다. AUTO 인증 요청은 생성 즉시 VERIFIED됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

특정 언어로 된 위치에 대해 요건을 충족하는 모든 인증 옵션을 보고합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

위치 인증을 생성 시간순으로 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

위치 인증 절차를 시작합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

AcceptInvitationRequest

AccessControl.AcceptInvitation 요청 메시지입니다.

필드
name

string

수락되는 초대의 이름입니다.

계정

계정은 비즈니스 위치를 담는 컨테이너입니다. 비즈니스의 위치를 관리하는 유일한 사용자인 경우 개인 Google 계정을 사용할 수 있습니다. 여러 사용자와 공동으로 위치를 관리하려면 비즈니스 계정을 만드세요.

필드
name

string

accounts/{account_id} 형식의 리소스 이름입니다.

account_name

string

계정의 이름입니다.

type

AccountType

출력 전용. 이 계정의 AccountType를 지정합니다.

role

AccountRole

출력 전용. 호출자가 이 계정에 대해 보유한 AccountRole를 지정합니다.

state

AccountState

출력 전용. 이 계정의 AccountState를 나타냅니다.

account_number

string

계정 참조 번호(프로비저닝된 경우)

permission_level

PermissionLevel

출력 전용. 호출자가 이 계정에 대해 보유한 PermissionLevel를 지정합니다.

organization_info

OrganizationInfo

조직의 추가 정보입니다. 조직 계정의 경우에만 채워집니다.

OrganizationInfo

조직에 대해 저장된 추가 정보입니다.

필드
registered_domain

string

계정에 등록된 도메인입니다.

postal_address

PostalAddress

계정의 우편 주소입니다.

phone_number

string

조직의 연락처 번호입니다.

AccountRole

인증된 사용자가 이 계정에 대해 갖는 액세스 수준을 나타냅니다. 자세한 내용은 고객센터 도움말을 참고하세요.

열거형
ACCOUNT_ROLE_UNSPECIFIED 지정되지 않음
OWNER 사용자가 이 계정을 소유합니다. (UI에는 '기본 소유자'로 표시됩니다.)
CO_OWNER 사용자가 계정의 공동 소유자입니다. (UI에 '소유자'로 표시됨)
MANAGER 사용자가 이 계정을 관리할 수 있습니다.
COMMUNITY_MANAGER 사용자는 계정의 소셜 (Google+) 페이지를 관리할 수 있습니다. (UI에는 '사이트 관리자'로 표시됨)

AccountState

Google에서 계정을 인증했는지 여부 등 계정의 상태를 나타냅니다.

필드
status

AccountStatus

인증을 받으면 향후 만들어지는 위치는 자동으로 Google 지도에 연결되고, 검토 없이도 Google+ 페이지가 생성됩니다.

AccountStatus

계정의 확인 상태를 나타냅니다.

열거형
ACCOUNT_STATUS_UNSPECIFIED 지정되지 않음
VERIFIED 인증된 계정입니다.
UNVERIFIED 계정이 인증되지 않았으며, 인증이 요청되지 않았습니다.
VERIFICATION_REQUESTED 인증이 요청되었으나 인증이 필요한 계정입니다.

AccountType

계정의 종류를 나타냅니다(개인/사용자 계정 또는 비즈니스 계정).

열거형
ACCOUNT_TYPE_UNSPECIFIED 지정되지 않음
PERSONAL 최종 사용자 계정.
LOCATION_GROUP 위치 그룹입니다. 자세한 내용은 고객센터 도움말을 참고하세요.
USER_GROUP 그룹으로 조직 직원을 분리하는 사용자 그룹 자세한 내용은 고객센터 도움말을 참고하세요.
ORGANIZATION 회사를 대표하는 조직입니다. 자세한 내용은 고객센터 도움말을 참고하세요.

AdWordsLocationExtensions

애드워즈에 표시되는 추가 정보입니다.

필드
ad_phone

string

위치의 기본 전화번호 대신 애드워즈 위치 광고 확장에 표시되는 대체 전화번호입니다.

AddressInput

ADDRESS 확인을 위한 입력입니다.

필드
mailer_contact_name

string

메일을 받을 연락처 이름입니다.

관리

Account 또는 Location의 관리자입니다.

필드
name

string

리소스 이름입니다. 계정 관리자의 경우 accounts/{account_id}/admins/{admin_id} 형식입니다.

위치 관리자의 경우 accounts/{account_id}/locations/{location_id}/admins/{admin_id} 형식입니다.

admin_name

string

관리자의 이름입니다. 처음 초대할 때 이 주소는 초대 대상자의 이메일 주소입니다. GET 호출 시 초대가 아직 대기 중이면 사용자의 이메일 주소가 반환됩니다. 그렇지 않으면 사용자의 성과 이름이 포함됩니다.

role

AdminRole

이 관리자가 지정된 Account 또는 Location 리소스와 함께 사용하는 AdminRole를 지정합니다.

pending_invitation

bool

출력 전용. 지정된 리소스에 대해 대기 중인 초대가 이 관리자에게 있는지 여부를 나타냅니다.

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

string

출력 전용. 답변 accounts/*/locations/*/questions/*/answers/*의 고유한 이름입니다.

author

Author

출력 전용. 답변 작성자입니다.

upvote_count

int32

출력 전용. 답변에 대한 찬성 투표 수입니다.

text

string

답변의 텍스트입니다. 공백이 아닌 문자를 하나 이상 포함해야 합니다. 최대 길이는 4,096자(영문 기준)입니다.

create_time

Timestamp

출력 전용. 답변이 작성된 시간의 타임스탬프입니다.

update_time

Timestamp

출력 전용. 답변이 마지막으로 수정된 시간의 타임스탬프입니다.

AssociateLocationRequest

Locations.AssociateLocationRequest 요청 메시지입니다.

필드
name

string

연결할 위치의 리소스 이름입니다.

place_id

string

설정할 연결입니다. 설정되지 않은 경우 일치하는 항목이 없음을 나타냅니다.

속성

위치 속성입니다. 속성은 위치에 대한 추가 정보를 제공합니다. 위치에 설정할 수 있는 속성은 해당 위치의 속성 (예: 카테고리)에 따라 다를 수 있습니다. 사용 가능한 속성은 Google에서 결정하며 API 변경 없이 추가 및 삭제될 수 있습니다.

필드
attribute_id

string

속성의 ID입니다. 속성 ID는 Google에서 제공합니다.

value_type

AttributeValueType

출력 전용. 이 속성에 포함된 값의 유형입니다. 값을 해석하는 방법을 결정하는 데 사용해야 합니다.

values[]

Value

이 속성의 값입니다. 제공된 값의 유형은 해당 속성에 예상되는 유형과 일치해야 합니다. AttributeValueType을 참고하세요. 여러 속성 값을 제공할 수 있는 반복되는 입력란입니다. 속성 유형은 하나의 값만 지원합니다.

repeated_enum_value

RepeatedEnumAttributeValue

속성 값 유형이 REPEATED_ENUM인 경우 이 속성에 속성 값이 포함되고 다른 값 필드는 비어 있어야 합니다.

url_values[]

UrlAttributeValue

속성 값 유형이 URL인 경우 이 입력란에는 이 속성의 값이 포함되며 다른 값 입력란은 비어 있어야 합니다.

AttributeMetadata

속성의 메타데이터입니다. 현지화된 이름과 관련 속성을 함께 그룹화하기 위한 제목을 비롯하여 속성의 표시 정보가 포함됩니다.

필드
attribute_id

string

속성의 ID입니다.

value_type

AttributeValueType

속성의 값 유형입니다. 설정 및 검색된 값은 이 유형이어야 합니다.

display_name

string

사용할 수 있는 경우 속성의 현지화된 표시 이름입니다. 그렇지 않은 경우 영어 표시 이름입니다.

group_display_name

string

사용할 수 있는 경우 이 속성을 포함하는 그룹의 현지화된 표시 이름이고, 그렇지 않은 경우 영어 그룹 이름입니다. 관련 속성은 그룹으로 수집되며 여기에 제공된 제목 아래 함께 표시되어야 합니다.

is_repeatable

bool

true인 경우 속성이 여러 값을 지원합니다. false인 경우 하나의 값만 제공해야 합니다.

value_metadata[]

AttributeValueMetadata

일부 속성 유형 (예: enum)의 경우 지원되는 값 목록과 이러한 값에 해당하는 표시 이름이 제공됩니다.

is_deprecated

bool

true인 경우 속성은 지원 중단되었으며 더 이상 사용하면 안 됩니다. 지원 중단된 경우 이 속성을 업데이트해도 오류가 발생하지는 않지만 업데이트가 저장되지 않습니다. 지원 중단되면 어느 시점이 되면 속성이 완전히 삭제되고 오류가 됩니다.

AttributeValueMetadata

지원되는 속성 값의 메타데이터입니다.

필드
value

Value

속성 값입니다.

display_name

string

이 값의 표시 이름으로, 가능한 경우 현지화되고 그렇지 않은 경우 영어입니다. 값 표시 이름은 속성 표시 이름과 함께 컨텍스트에서 사용하기 위한 것입니다.

예를 들어 'Wi-Fi' 열거형 속성의 경우 유료 Wi-Fi를 나타내는 'paid'가 포함될 수 있습니다.

AttributeValueType

속성의 값 유형입니다.

열거형
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED 지정되지 않음
BOOL 이 속성의 값은 부울 값입니다.
ENUM 이 속성에는 사용할 수 있는 사용 가능한 값의 사전 결정된 목록이 있습니다. 이 속성의 메타데이터는 이러한 값을 나열합니다.
URL 이 속성의 값은 URL입니다.
REPEATED_ENUM 속성 값은 명시적으로 설정하거나 설정 해제할 수 있는 여러 값이 가능한 열거형입니다.

작성자

질문 또는 답변의 작성자를 나타냅니다.

필드
display_name

string

사용자의 표시 이름

profile_photo_url

string

사용자의 프로필 사진 URL입니다.

type

AuthorType

작성자가 속하는 사용자 유형입니다.

AuthorType

작성자가 속하는 사용자 유형의 열거형입니다.

열거형
AUTHOR_TYPE_UNSPECIFIED 사용해서는 안 됩니다.
REGULAR_USER 일반 사용자입니다.
LOCAL_GUIDE 지역 가이드
MERCHANT 위치의 소유자/관리자

BasicMetricsRequest

기본 측정항목 통계 요청입니다.

필드
metric_requests[]

MetricRequest

데이터 반환 방법에 대한 옵션을 포함하여 값을 반환하는 측정항목의 모음입니다.

time_range

TimeRange

측정항목을 수집할 범위입니다. 최대 기간은 요청일로부터 18개월입니다. 요청 날짜와 가까운 날짜에 데이터가 누락되는 경우도 있습니다. 누락된 데이터는 응답의 metricValues에 지정됩니다.

BatchGetBusinessCategoriesRequest

BusinessCategories.BatchGetBusinessCategories 요청 메시지입니다.

필드
language_code

string

필수 항목입니다. 카테고리 이름이 반환되어야 하는 BCP 47 언어 코드입니다.

category_ids[]

string

필수 항목입니다. 이름을 하나 이상 설정해야 합니다. 현지화된 카테고리 이름이 반환되어야 하는 GConcept ID입니다.

region_code

string

선택사항입니다. 비표준 언어를 유추하는 데 사용되는 ISO 3166-1 alpha-2 국가 코드입니다.

view

CategoryView

필수 항목입니다. 카테고리 리소스에 대해 응답으로 반환해야 하는 부분을 지정합니다.

BatchGetBusinessCategoriesResponse

BusinessCategories.BatchGetBusinessCategories의 응답 메시지입니다.

필드
categories[]

Category

요청에 제공된 GConcept ID와 일치하는 카테고리입니다. 요청에 있는 카테고리 ID와 동일한 순서로 나오지는 않습니다.

BatchGetLocationsRequest

Locations.BatchGetLocations 요청 메시지입니다.

필드
name

string

위치를 가져올 계정의 이름입니다.

location_names[]

string

가져올 위치의 모음으로, 이름으로 지정됩니다.

BatchGetLocationsResponse

Locations.BatchGetLocations의 응답 메시지입니다.

필드
locations[]

Location

위치의 모음입니다.

BatchGetReviewsRequest

Reviews.BatchGetReviews 요청 메시지입니다.

필드
name

string

여러 위치에 대한 리뷰 목록을 가져올 계정의 이름입니다.

location_names[]

string

리뷰를 가져올 위치의 모음이며 이름으로 지정됩니다.

page_size

int32

페이지당 가져올 리뷰 수입니다. 기본값은 50개입니다.

page_token

string

지정하면 다음 리뷰 페이지를 가져옵니다.

order_by

string

선택사항입니다. 리뷰 정렬의 기준이 될 필드를 지정합니다. 지정하지 않으면 반환되는 리뷰 순서가 기본적으로 update_time desc로 설정됩니다. 정렬할 올바른 순서는 rating, rating desc, update_time desc입니다. rating는 오름차순으로 리뷰를 반환합니다. update_time(오름차순)는 지원되지 않습니다.

ignore_rating_only_reviews

bool

평가 전용 리뷰를 무시할지 여부입니다.

BatchGetReviewsResponse

Reviews.BatchGetReviews의 응답 메시지입니다.

필드
location_reviews[]

LocationReview

위치 정보가 포함된 리뷰입니다.

next_page_token

string

리뷰 수가 요청된 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 리뷰 페이지를 가져오는 토큰으로 채워집니다. 리뷰가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다.

BusinessHours

이 위치의 영업시간을 나타냅니다. TimePeriod 인스턴스 컬렉션을 보유합니다.

필드
periods[]

TimePeriod

이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

CallToAction

사용자가 게시물을 클릭할 때 수행되는 동작입니다.

필드
action_type

ActionType

수행될 동작 유형입니다.

url

string

클릭 시 사용자가 연결되는 URL입니다. 통화 CTA에서는 이 필드를 설정되지 않은 상태로 두어야 합니다.

ActionType

수행될 동작 유형입니다.

열거형
ACTION_TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
BOOK 사용자가 약속/테이블 등을 예약하도록 유도하는 게시물입니다.
ORDER 사용자의 주문을 유도하는 게시물입니다.
SHOP 사용자가 제품 카탈로그를 둘러보도록 유도하는 게시물입니다.
LEARN_MORE 사용자가 웹사이트에서 자세한 내용을 확인하도록 유도하는 게시물입니다.
SIGN_UP 사용자의 등록/가입/참여를 유도하는 게시물입니다.
GET_OFFER

지원이 중단되었습니다. LocalPostTopicType에서 OFFER를 사용하여 혜택 콘텐츠가 포함된 게시물을 만드세요.

CALL 사용자가 비즈니스에 전화하도록 유도하는 게시물입니다.

카테고리

이 비즈니스의 업무 내용이 아니라 업종을 설명하는 카테고리입니다. 유효한 카테고리 ID 목록과 사람이 읽을 수 있는 이름에 대한 매핑은 categories.list를 참조하세요.

필드
display_name

string

. 사람이 읽을 수 있는 카테고리 이름입니다. 위치를 읽을 때 설정됩니다. 위치를 수정할 때는 category_id를 설정해야 합니다.

참고: 이 필드는 응답에만 사용됩니다. 요청에서 여기에 지정된 값은 무시됩니다.

category_id

string

. 이 카테고리의 안정적인 ID입니다 (Google에서 제공). 카테고리를 수정할 때 (위치를 만들거나 업데이트할 때) category_id를 지정해야 합니다.

참고: 이 필드는 응답에만 사용됩니다. 요청에서 여기에 지정된 값은 무시됩니다.

service_types[]

ServiceType

. 이 비즈니스 카테고리에서 사용할 수 있는 모든 서비스 유형의 목록입니다.

참고: 이 필드는 응답에만 사용됩니다. 요청에서 여기에 지정된 값은 무시됩니다.

more_hours_types[]

MoreHoursType

출력 전용. 이 비즈니스 카테고리에 사용할 수 있는 기타 영업시간 유형입니다.

CategoryView

서버에서 반환하는 데이터의 양을 제한하는 데 도움이 되는 enum입니다.

열거형
CATEGORY_VIEW_UNSPECIFIED 지정되지 않으며 CATEGORY_METADATA_ONLY와 같습니다.
BASIC 서버 응답에는 카테고리 필드 display_name, category_id, language_code만 포함됩니다. 서비스 유형 메타데이터 관련 필드가 생략됩니다.
FULL 응답의 모든 필드를 반환합니다.

체인

체인은 비즈니스 위치와 제휴할 수 있는 브랜드입니다.

필드
name

string

chains/{chain_place_id} 형식의 체인 리소스 이름입니다.

chain_names[]

ChainName

체인의 이름입니다.

websites[]

ChainUrl

체인의 웹사이트입니다.

location_count

int32

이 체인에 속한 위치의 수입니다.

ChainName

체인을 표시할 때 사용할 이름입니다.

필드
display_name

string

이 체인의 표시 이름입니다.

language_code

string

이름의 언어로 된 BCP 47 코드입니다.

ChainUrl

체인을 표시할 때 사용되는 URL입니다.

필드
url

string

체인의 URL입니다.

ClearLocationAssociationRequest

Locations.ClearLocationAssociationRequest의 요청 메시지입니다.

필드
name

string

연결 해제할 위치의 리소스 이름입니다.

CompleteVerificationRequest

Verifications.CompleteVerificationAction 요청 메시지입니다.

필드
name

string

완료할 인증의 리소스 이름입니다.

pin

string

인증을 완료하기 위해 판매자가 받은 PIN 코드입니다.

CompleteVerificationResponse

Verifications.CompleteVerificationAction의 응답 메시지입니다.

필드
verification

Verification

완료된 인증

CreateAccountAdminRequest

AccessControl.CreateAccountAdmin 요청 메시지입니다.

필드
parent

string

이 관리자가 생성된 계정의 리소스 이름입니다.

admin

Admin

생성할 관리자입니다.

CreateAccountRequest

Accounts.CreateAccount에 대한 요청 메시지입니다.

필드
primary_owner

string

생성 중인 계정의 기본 소유자가 될 계정의 리소스 이름입니다. accounts/{account_id}/ 형식이어야 합니다.

account

Account

생성할 계정의 계정 정보입니다. 계정 이름 및 유형 필드만 허용됩니다.

CreateLocalPostRequest

CreateLocalPost 요청 메시지입니다.

필드
parent

string

이 지역 게시물을 생성할 위치의 이름입니다.

local_post

LocalPost

새 지역 게시물 메타데이터입니다.

CreateLocationAdminRequest

AccessControl.CreateLocationAdmin 요청 메시지입니다.

필드
parent

string

이 관리자가 생성된 위치의 리소스 이름입니다.

admin

Admin

생성할 관리자입니다.

CreateLocationRequest

Locations.CreateLocation 요청 메시지입니다.

필드
parent

string

이 위치를 만들 계정의 이름입니다.

location

Location

새 위치 메타데이터입니다.

validate_only

bool

true인 경우 실제로 위치를 생성하지 않고 요청의 유효성이 검사됩니다.

request_id

string

서버에서 중복 요청을 감지하는 고유한 요청 ID입니다. UUID를 사용하는 것이 좋습니다. 최대 길이는 50자(영문 기준)입니다.

CreateMediaItemRequest

Media.CreateMediaItem 요청 메시지입니다.

필드
parent

string

이 미디어 항목이 생성될 위치의 리소스 이름입니다.

media_item

MediaItem

생성될 미디어 항목입니다.

CreateQuestionRequest

QuestionsAndAnswers.CreateQuestion 요청 메시지입니다.

필드
parent

string

질문을 작성할 위치의 이름입니다.

question

Question

새로운 질문

DeclineInvitationRequest

AccessControl.DeclineInvitation 요청 메시지입니다.

필드
name

string

거부된 계정 초대의 이름입니다.

DeleteAccountAdminRequest

AccessControl.DeleteAccountAdmin 요청 메시지입니다.

필드
name

string

계정에서 삭제할 관리자의 리소스 이름입니다.

DeleteAnswerRequest

QuestionsAndAnswers.DeleteAnswer 요청 메시지입니다.

필드
parent

string

답변을 삭제할 질문의 이름입니다.

DeleteLocalPostRequest

DeleteLocalPost 요청 메시지입니다.

필드
name

string

삭제할 지역 게시물의 이름입니다.

DeleteLocationAdminRequest

AccessControl.DeleteLocationAdmin 요청 메시지입니다.

필드
name

string

위치에서 삭제할 관리자의 리소스 이름입니다.

DeleteLocationRequest

Locations.DeleteLocation 요청 메시지입니다.

필드
name

string

삭제할 위치의 이름입니다.

DeleteMediaItemRequest

Media.DeleteMediaItem 요청 메시지입니다.

필드
name

string

삭제할 미디어 항목의 이름입니다.

DeleteNotificationsRequest

Accounts.DeleteNotifications 요청 메시지입니다.

필드
name

string

삭제할 알림 설정의 리소스 이름입니다.

DeleteQuestionRequest

QuestionsAndAnswers.DeleteQuestion 요청 메시지입니다.

필드
name

string

삭제할 질문의 이름입니다.

DeleteReviewReplyRequest

Reviews.DeleteReviewReply 요청 메시지입니다.

필드
name

string

삭제할 리뷰 답글의 이름입니다.

DietaryRestriction

식품의 식이 정보입니다.

열거형
DIETARY_RESTRICTION_UNSPECIFIED 식이 유형 미지정
HALAL 음식을 할랄 음식으로 표현
KOSHER 음식을 코셔 요리로 표현
ORGANIC 유기농 음식으로 표현된 음식
VEGAN 비건 음식으로 표현한 음식입니다.
VEGETARIAN 음식을 채식 요리로 표현

DimensionalMetricValue

특정 시간 측정기준을 가진 단일 측정항목의 값입니다.

필드
metric_option

MetricOption

이 측정기준 값을 요청한 옵션입니다.

time_dimension

TimeDimension

값의 측정기준입니다.

value

Int64Value

값입니다. 값이 설정되지 않으면 요청된 데이터가 누락됩니다.

TimeDimension

데이터를 나누는 측정기준입니다.

필드
day_of_week

DayOfWeek

이 값에 해당하는 요일 ('MONDAY'부터 'SUNDAY'까지)입니다. BREAKDOWN_DAY_OF_WEEK 옵션에 설정합니다.

time_of_day

TimeOfDay

이 값에 해당하는 시간 (0~23)입니다. BREAKDOWN_HOUR_OF_DAY 옵션에 대해 설정되었습니다.

time_range

TimeRange

이 값이 포함되는 시간 범위입니다. AGGREGATED_TOTAL 및 AGGREGATED_DAILY 옵션에 대해 설정합니다.

DrivingDirectionMetricsRequest

운전 경로 통계 요청입니다.

필드
num_days

NumDays

데이터를 집계할 일수입니다. 반환된 결과는 요청된 마지막 일수 동안의 데이터를 사용할 수 있습니다. 유효한 값은 7, 30, 90입니다.

language_code

string

언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다.

NumDays

이 요청이 지원할 수 있는 일수입니다.

열거형
SEVEN 7일. 기본값입니다.
THIRTY 30일
NINETY 90일

EmailInput

이메일 확인을 위한 입력입니다.

필드
email_address

string

PIN을 받을 이메일 주소입니다.

이메일 주소는 FetchVerificationOptions에서 제공한 주소 중 하나인 경우에만 허용됩니다. EmailVerificationData의 is_user_name_edit이 true로 설정되어 있으면 클라이언트는 다른 사용자 이름 (로컬 부분)을 지정할 수 있지만 도메인 이름과 일치해야 합니다.

ErrorDetail

유효성 검사 또는 내부 실패를 초래한 오류에 대한 세부정보입니다.

필드
code

int32

상태 코드로, ErrorCode의 열거형 값이어야 합니다.

field

string

요청 본문의 필드로 연결되는 경로입니다. 값은 프로토콜 버퍼 필드를 식별하는 점으로 구분된 식별자 시퀀스입니다. 예를 들어 'error_details.field'는 이 필드를 식별합니다.

message

string

필드로 인한 실패 발생 이유에 대한 설명입니다. 메시지는 영어로 작성되어 사용자에게 표시하기에 적합하지 않을 수 있습니다.

value

string

요청에 실패한 값입니다.

field_index

int32

이 오류를 생성한 요청 필드가 반복되면 유효성 검사 실패를 야기한 해당 필드의 항목 색인(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

string

확인할 위치의 리소스 이름입니다.

language_code

string

인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다. 사용 가능한 옵션은 언어에 따라 다릅니다.

context

ServiceBusinessContext

서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에 필수입니다. 다른 비즈니스 유형의 위치에 설정된 경우 INVALID_이(가) 발생합니다.

FetchVerificationOptionsResponse

Verifications.FetchVerificationOptions의 응답 메시지입니다.

필드
options[]

VerificationOption

사용 가능한 인증 옵션입니다.

FindMatchingLocationsRequest

Locations.FindMatchingLocations 요청 메시지입니다.

필드
name

string

일치하는 항목을 찾을 위치의 리소스 이름입니다.

language_code

string

일치하는 위치의 기본 언어입니다 (BCP-47 형식).

num_results

int32

반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청하면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기 기능이 없습니다.

max_cache_duration

Duration

지원이 중단되었습니다. 이 필드는 모든 요청에서 무시됩니다.

FindMatchingLocationsResponse

Locations.FindMatchingLocations의 응답 메시지입니다.

필드
matched_locations[]

MatchedLocation

지정된 위치와 일치할 가능성이 있는 위치의 모음으로, 가장 일치하는 항목에서 가장 낮은 위치 순서로 나열됩니다. 정확히 일치하는 항목이 있으면 첫 번째 위치에 배치됩니다.

match_time

Timestamp

이 위치의 일치 알고리즘이 마지막으로 실행된 시간입니다.

FollowersMetadata

위치의 팔로어 메타데이터입니다.

필드
name

string

리소스 이름입니다. accounts/{account_id}/locations/{location_id}/followers/metadata

count

uint64

위치의 총 팔로어 수입니다.

FoodMenu

음식 요리를 제공하는 비즈니스의 메뉴입니다.

필드
labels[]

MenuLabel

필수 항목입니다. 언어 태그가 지정된 메뉴 라벨입니다. 예: '메뉴', '점심 특별 메뉴' 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

source_url

string

선택사항입니다. 이동할 웹페이지가 있는 경우 메뉴의 소스 URL입니다.

sections[]

FoodMenuSection

필수 항목입니다. 메뉴의 섹션.

cuisines[]

Cuisine

선택사항입니다. 음식 메뉴의 요리 정보입니다. 이 입력란을 제공하는 것이 좋습니다.

요리

식당의 요리 정보입니다.

열거형
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[]

MenuLabel

필수 항목입니다. 이 메뉴 항목의 언어 태그 라벨입니다. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

attributes

FoodMenuItemAttributes

필수 항목입니다. 상품의 세부 속성입니다. 항목 옵션이 지정되면 이 속성이 기본 속성으로 간주되어 각 옵션에 채워집니다.

options[]

FoodMenuItemOption

선택사항입니다. 이는 여러 가지 옵션이 제공되는 상품에 관한 것이며 사용자가 직접 선택해야 합니다. 예: '일반' 또는 '라지' 피자 옵션을 지정하면 항목 수준의 라벨과 속성이 자동으로 첫 번째 옵션의 라벨 및 속성이 됩니다. 클라이언트는 이 입력란에 다른 추가 음식 옵션만 지정하면 됩니다.

FoodMenuItemAttributes

식품/요리의 속성입니다.

필드
price

Money

필수 항목입니다. 음식의 가격입니다.

spiciness

Spiciness

선택사항입니다. 음식의 매운 정도입니다.

allergen[]

Allergen

선택사항입니다. 음식과 관련된 알레르기 유발 물질입니다. 이 입력란을 제공하는 것이 좋습니다.

dietary_restriction[]

DietaryRestriction

선택사항입니다. 음식의 식이 정보입니다. 이 입력란을 제공하는 것이 좋습니다.

nutrition_facts

NutritionFacts

선택사항입니다. 음식 옵션의 영양 성분입니다. 이 입력란을 제공하는 것이 좋습니다.

ingredients[]

Ingredient

선택사항입니다. 음식 요리 옵션의 재료입니다.

serves_num_people

int32

선택사항입니다. 이 음식 옵션으로 주문 가능한 인원수입니다.

preparation_methods[]

PreparationMethod

선택사항입니다. 음식 요리 옵션을 준비하는 방법입니다.

portion_size

PortionSize

선택사항입니다. 주문 규모(상품 단위로 표시됨) (예: '꼬챙이' 4개, '조각' 6개')

media_keys[]

string

선택사항입니다. 요리와 연결된 미디어의 미디어 키입니다. 사진 미디어만 지원됩니다. 연결된 사진이 여러 개인 경우 첫 번째 사진이 기본 사진으로 간주됩니다.

재료

이 메시지는 음식의 재료 정보를 나타냅니다.

필드
labels[]

MenuLabel

필수 항목입니다. 재료를 설명하는 라벨입니다. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

PortionSize

한 조각씩 서빙하는 음식의 분량입니다.

필드
quantity

int32

필수 항목입니다. 부분 수입니다.

unit[]

MenuLabel

필수 항목입니다. 반복되는 name_info 필드는 여러 언어로 된 단위에 사용됩니다.

FoodMenuItemOption

항목의 옵션입니다. 사용자를 명시적으로 선택해야 합니다.

필드
labels[]

MenuLabel

필수 항목입니다. 이 메뉴 항목 옵션의 언어 태그 라벨입니다. E.g.: 'beef pad thai', 'veggie pad thai', 'small pizza', 'large pizza'. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

attributes

FoodMenuItemAttributes

필수 항목입니다. 상품 옵션의 세부 속성입니다. 지정되지 않은 개별 속성은 상품 수준 속성을 기반으로 상속됩니다.

FoodMenuSection

메뉴의 섹션입니다. 여러 항목/요리를 포함할 수 있습니다.

필드
labels[]

MenuLabel

필수 항목입니다. 이 메뉴 섹션의 언어 태그 라벨입니다. 표시 이름은 140자(영문 기준) 이하여야 하며 설명은 1,000자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

items[]

FoodMenuItem

필수 항목입니다. 섹션의 항목입니다. 각 섹션에는 항목이 1개 이상 있어야 합니다.

FoodMenus

음식 요리를 제공하는 비즈니스의 메뉴입니다.

필드
name

string

필수 항목입니다. 이 위치의 Google 식별자(형식: accounts/{account_id}/locations/{location_id}/foodMenus)

menus[]

FoodMenu

선택사항입니다. 음식 메뉴의 컬렉션입니다.

GenerateAccountNumberRequest

Accounts.GenerateAccountNumber 요청 메시지입니다.

필드
name

string

계좌 번호를 생성할 계정의 이름입니다.

GetAccountRequest

Accounts.GetAccount에 대한 요청 메시지입니다.

필드
name

string

가져올 계정의 이름입니다.

GetChainRequest

Locations.GetChain 요청 메시지입니다.

필드
name

string

chains/{chain_place_id} 형식의 체인 리소스 이름입니다.

GetCustomerMediaItemRequest

Media.GetCustomerMediaItem 요청 메시지입니다.

필드
name

string

요청된 고객 미디어 항목의 리소스 이름입니다.

GetFollowersMetadataRequest

위치의 팔로어 메타데이터를 가져오는 요청 메시지입니다.

필드
name

string

위치의 팔로어 메타데이터의 리소스 이름입니다. accounts/{account_id}/locations/{location_id}/followers/metadata

GetFoodMenusRequest

FoodMenu.GetFoodMenus 요청 메시지입니다.

필드
name

string

필수 항목입니다. 이 위치의 Google 식별자(형식: accounts/{account_id}/locations/{location_id}/foodMenus)

read_mask

FieldMask

선택사항입니다. 반환할 특정 필드입니다. 마스크를 지정하지 않으면 전체 FoodMenu('*'와 동일)를 반환합니다. 반복되는 필드 항목은 개별적으로 지정할 수 없습니다. 예를 들어 'name' 및 'menus'는 유효한 마스크이지만 'menus.sections'는 유효하지 않습니다.

GetHealthProviderAttributesRequest

HealthProviderAttributes.GetHealthProviderAttributes 요청 메시지입니다.

필드
name

string

필수 항목입니다. 이 위치의 Google 식별자로, accounts/{account_id}/locations/{location_id}/healthProviderAttributes 형식입니다.

language_code

string

선택사항입니다. 언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다. 지금은 'en'만 지원됩니다.

GetLocalPostRequest

LocalPosts.GetLocalPost 요청 메시지입니다.

필드
name

string

가져올 지역 게시물의 이름입니다.

GetLocationRequest

Locations.GetLocation 요청 메시지입니다.

필드
name

string

가져올 위치의 이름입니다.

GetMediaItemRequest

Media.GetMediaItem 요청 메시지입니다.

필드
name

string

요청된 미디어 항목의 이름입니다.

GetNotificationsRequest

Accounts.GetNotifications 요청 메시지입니다.

필드
name

string

알림 설정 리소스 이름입니다.

GetReviewRequest

Reviews.GetReview 요청 메시지입니다.

필드
name

string

가져올 리뷰의 이름입니다.

GetServiceListRequest

서비스 목록 요청 메시지를 가져옵니다.

필드
name

string

필수 항목입니다. 이 위치의 Google 식별자(형식: accounts/{account_id}/locations/{location_id}/servicelist)

GoogleLocation

Google에 있는 Location를 나타냅니다. 이 위치는 사용자 또는 다른 사용자가 소유권을 주장했거나 소유권을 주장하지 않을 수 있는 위치일 수 있습니다.

필드
name

string

이 GoogleLocation의 리소스 이름으로, googleLocations/{googleLocationId} 형식입니다.

location

Location

희소하게 채워진 Location 정보. 이 필드는 현재 사용자가 소유권을 주장하지 않는 경우 CreateLocation에서 재사용할 수 있습니다.

request_admin_rights_url

string

사용자를 관리자 권한 요청 UI로 리디렉션하는 URL입니다. 이 필드는 현재 사용자를 포함하여 다른 사용자가 이미 위치의 소유권을 주장한 경우에만 표시됩니다.

GoogleUpdatedLocation

Google에서 수정한 위치를 나타냅니다.

필드
location

Location

이 위치의 Google 업데이트 버전입니다.

diff_mask

FieldMask

Google에서 업데이트한 필드

HealthProviderAttributes

이 위치와 연결된 의료인 속성입니다.

필드
name

string

필수 항목입니다. 이 위치의 Google 식별자(형식: accounts/{account_id}/locations/{location_id}/healthProviderAttributes)

insurance_networks[]

InsuranceNetwork

선택사항입니다. 이 위치에서 적용되는 보험 네트워크의 목록입니다.

InsuranceNetwork

단일 보험 네트워크 다음 ID: 5

필드
network_id

string

필수 항목입니다. Google에서 생성한 이 보험 네트워크의 ID입니다.

network_names

map<string, string>

출력 전용. 요청된 언어로 된 네트워크 표시 이름 맵입니다. 여기서 언어는 키이고 현지화된 표시 이름은 값입니다. 기본적으로 영어로 된 표시 이름이 설정되어 있습니다.

payer_names

map<string, string>

출력 전용. 요청된 언어로 된 결제자 표시 이름 맵입니다. 여기서 언어는 키이고 현지화된 표시 이름은 값입니다. 기본적으로 영어로 된 표시 이름이 설정되어 있습니다.

state

NetworkState

출력 전용. 이 보험 네트워크의 상태입니다.

InternalError

내부 오류를 설명합니다.

필드
error_details[]

ErrorDetail

개별 오류를 자세히 설명합니다.

초대장

출력 전용. 대기 중인 초대를 나타냅니다.

필드
name

string

초대의 리소스 이름입니다.

role

AdminRole

계정의 초대된 역할

통합 필드 target. 이 초대의 대상을 나타냅니다. target은 다음 중 하나여야 합니다.
target_account

Account

이 초대장에 사용되는 계정의 사용자 밀도가 낮습니다.

target_location

TargetLocation

이 초대의 대상 위치입니다.

TargetLocation

대기 중인 초대의 대상 위치를 나타냅니다.

필드
location_name

string

사용자가 초대된 위치의 이름입니다.

location_address

string

사용자가 초대된 위치의 주소입니다.

ListAccountAdminsRequest

AccessControl.ListAccountAdmins에 대한 요청 메시지입니다.

필드
parent

string

관리자 목록을 검색할 계정의 이름입니다.

ListAccountAdminsResponse

AccessControl.ListAccountAdmins의 응답 메시지입니다.

필드
admins[]

Admin

Admin 인스턴스 컬렉션입니다.

ListAccountsRequest

Accounts.ListAccounts의 요청 메시지입니다.

필드
page_size

int32

페이지당 가져올 계정 수입니다. 기본값은 20, 최소는 2, 최대 페이지 크기는 20입니다.

page_token

string

지정하면 계정의 다음 페이지가 검색됩니다. accounts.list 호출이 요청된 페이지 크기에 넣을 수 있는 것보다 많은 결과를 반환하는 경우 pageToken이 반환됩니다.

name

string

직접 액세스할 수 있는 계정 목록을 가져올 계정의 리소스 이름입니다. 이는 조직 및 사용자 그룹에만 적용됩니다. 비어 있으면 인증된 사용자의 ListAccounts를 반환합니다.

filter

string

계정의 반환을 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. filter가 비어 있으면 제약 조건이 적용되지 않고 요청된 계정에 대해 모든 계정 (페이지 매김)을 가져옵니다.

예를 들어 type=USER_GROUP 필터가 있는 요청은 사용자 그룹만 반환합니다.

ListAccountsResponse

Accounts.ListAccounts의 응답 메시지입니다.

필드
accounts[]

Account

사용자가 액세스할 수 있는 계정의 모음입니다. 쿼리를 수행하는 사용자의 개인 계정이 필터링되지 않는 한 항상 결과의 첫 번째 항목이 됩니다.

next_page_token

string

계정 수가 요청된 페이지 크기를 초과하면 이 필드는 accounts.list에 대한 후속 호출에서 다음 계정 페이지를 가져오는 토큰으로 채워집니다. 더 이상 계정이 없으면 응답에 이 필드가 표시되지 않습니다.

ListAnswersRequest

QuestionsAndAnswers.ListAnswers 요청 메시지입니다.

필드
parent

string

답변을 가져올 질문의 이름입니다.

page_size

int32

페이지당 가져올 답변 수입니다. 기본 및 최대 page_size 값은 10입니다.

page_token

string

지정하면 답변의 다음 페이지가 검색됩니다.

order_by

string

답변을 반환하는 순서입니다. 유효한 옵션으로는 'update_time desc'와 'upvote_count desc'가 있습니다. 이 경우 요청된 필드를 기준으로 내림차순으로 정렬된 답변을 반환합니다. 기본 정렬 순서는 'update_time desc'입니다.

ListAnswersResponse

QuestionsAndAnswers.List Answers에 대한 응답 메시지입니다.

필드
answers[]

Answer

요청된 답변입니다.

total_size

int32

모든 페이지에서 이 질문에 대해 게시된 총 답변 수입니다.

next_page_token

string

답변 수가 요청된 최대 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 답변 페이지를 가져오는 토큰으로 채워집니다. 더 이상 답변이 없으면 응답에 이 필드가 표시되지 않습니다.

ListAttributeMetadataRequest

Locations.ListAttributeMetadata 요청 메시지입니다. 위치 리소스 이름을 입력하면 해당 위치가 나머지 기준을 채우는 데 사용됩니다. 없는 경우 카테고리와 국가를 입력해야 합니다.

필드
name

string

사용 가능한 속성을 조회할 위치의 리소스 이름입니다.

category_id

string

사용 가능한 속성을 찾기 위한 기본 카테고리의 안정적인 ID입니다.

country

string

사용 가능한 속성을 찾기 위한 ISO 3166-1 alpha-2 국가 코드입니다.

language_code

string

속성 표시 이름을 가져올 BCP 47 언어 코드입니다. 이 언어를 사용할 수 없는 경우 영어로 제공됩니다.

page_size

int32

페이지당 포함할 속성 수입니다. 기본값은 200, 최솟값은 1입니다.

page_token

string

지정하면 속성 메타데이터의 다음 페이지가 검색됩니다. attributes.list 호출이 요청된 페이지 크기에 넣을 수 있는 것보다 많은 결과를 반환하는 경우 pageToken이 반환됩니다.

ListAttributeMetadataResponse

Locations.ListAttributeMetadata의 응답 메시지입니다.

필드
attributes[]

AttributeMetadata

사용 가능한 속성의 속성 메타데이터 모음입니다.

next_page_token

string

속성 수가 요청된 페이지 크기를 초과하면 이 필드는 attributes.list에 대한 후속 호출에서 다음 속성 페이지를 가져오는 토큰으로 채워집니다. 속성이 더 이상 없으면 이 필드는 응답에 표시되지 않습니다.

ListBusinessCategoriesRequest

필드
region_code

string

ISO 3166-1 alpha-2 국가 코드입니다.

language_code

string

BCP 47 언어 코드입니다. 언어를 사용할 수 없는 경우 영어로 기본 설정됩니다.

search_term

string

사용자의 필터 문자열(선택사항)입니다.

page_size

int32

페이지당 가져올 카테고리 수입니다. 기본값은 100, 최소는 1, 최대 페이지 크기는 100입니다.

page_token

string

지정하면 카테고리의 다음 페이지를 가져옵니다.

view

CategoryView

선택사항입니다. 카테고리 리소스에 대해 응답으로 반환해야 하는 부분을 지정합니다.

ListBusinessCategoriesResponse

필드
categories[]

Category

카테고리입니다. 카테고리는 기본 보기입니다. ServiceType 정보를 포함하지 않습니다.

total_category_count

int32

요청 매개변수의 총 카테고리 수입니다.

next_page_token

string

카테고리 수가 요청된 페이지 크기를 초과하면 이 필드는 ListBusinessCategories에 대한 후속 호출에서 다음 카테고리 페이지를 가져오는 토큰으로 채워집니다.

ListCustomerMediaItemsRequest

Media.ListCustomerMediaItems 요청 메시지입니다.

필드
parent

string

고객 미디어 항목이 나열될 위치의 이름입니다.

page_size

int32

페이지당 반환할 미디어 항목의 수입니다. 기본값은 100이며 지원되는 최대 페이지 크기는 200입니다.

page_token

string

지정하면 미디어 항목의 다음 페이지가 반환됩니다.

ListCustomerMediaItemsResponse

Media.ListCustomerMediaItems 응답 메시지입니다.

필드
media_items[]

MediaItem

반환된 미디어 항목 목록입니다.

total_media_item_count

int32

페이지로 나누기와 관계없이 이 위치의 총 미디어 항목 수입니다. 특히 여러 개의 결과 페이지가 있는 경우 이 값은 근사치입니다.

next_page_token

string

요청된 페이지 크기보다 더 많은 미디어 항목이 있는 경우 ListCustomerMediaItems에 대한 후속 호출에서 미디어 항목의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다.

ListInsuranceNetworksRequest

InsuranceNetworkService.ListInsuranceNetworks 요청 메시지입니다.

필드
parent

string

필수 항목입니다. 보험 네트워크가 나열될 위치의 이름입니다. 이름의 형식은 다음과 같습니다. accounts/{account_id}/locations/{location_id}

language_code

string

선택사항입니다. 언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다. 지금은 'en'만 지원됩니다.

page_size

int32

페이지당 반환할 보험 네트워크의 수입니다. 기본값은 5,000입니다. 최대 페이지 크기는 10,000입니다.

page_token

string

지정하면 보험 네트워크의 다음 페이지가 반환됩니다.

ListInsuranceNetworksResponse

InsuranceNetworkService.ListInsuranceNetworks의 응답 메시지입니다.

필드
networks[]

InsuranceNetwork

Google에서 지원하는 보험 네트워크의 목록입니다.

next_page_token

string

요청된 페이지 크기보다 보험 네트워크가 더 많은 경우 ListInsuranceNetworks에 대한 후속 호출에서 보험 네트워크의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다.

ListInvitationsRequest

AccessControl.ListInvitations 요청 메시지입니다.

필드
parent

string

초대 목록을 가져오는 계정의 이름입니다.

target_type

TargetType

응답에 표시되어야 하는 타겟 유형을 지정합니다.

TargetType

초대 대상의 유형입니다.

열거형
ALL 모든 대상 유형에 대한 초대를 나열합니다. 이는 기본값입니다.
ACCOUNTS_ONLY 계정 유형의 대상에 대한 초대만 나열합니다.
LOCATIONS_ONLY 위치 유형의 대상에 대한 초대만 나열합니다.

ListInvitationsResponse

AccessControl.ListInvitations의 응답 메시지입니다.

필드
invitations[]

Invitation

계정에서 대기 중인 위치 초대 모음입니다. 여기에 표시된 초대장 수는 1,000개를 초과할 수 없습니다.

ListLocalPostsRequest

ListLocalPosts 요청 메시지입니다.

필드
parent

string

지역 게시물이 표시될 위치의 이름입니다.

page_size

int32

페이지당 반환할 지역 게시물 수입니다. 기본값은 20입니다. 최소 1, 최대 페이지 크기는 100입니다.

page_token

string

지정하면 지역 게시물의 다음 페이지가 반환됩니다.

ListLocalPostsResponse

ListLocalPosts의 응답 메시지입니다.

필드
local_posts[]

LocalPost

반환된 지역 게시물 목록입니다.

next_page_token

string

요청된 페이지 크기보다 로컬 게시물이 더 많은 경우, ListLocalPosts에 대한 후속 호출에서 로컬 게시물의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다.

ListLocationAdminsRequest

AccessControl.ListLocationAdmins의 요청 메시지입니다.

필드
parent

string

관리자를 나열할 위치의 이름입니다.

ListLocationAdminsResponse

AccessControl.ListLocationAdmins의 응답 메시지입니다.

필드
admins[]

Admin

Admin 인스턴스 컬렉션입니다.

ListLocationsRequest

Locations.ListLocations 요청 메시지입니다.

필드
parent

string

위치를 가져올 계정의 이름입니다. AccountAccountType 개인인 경우 계정에서 직접 소유한 위치만 반환됩니다. 그렇지 않으면 계정에서 직접 또는 간접적으로 액세스할 수 있는 모든 위치가 반환됩니다.

page_size

int32

페이지당 가져올 위치 수입니다. 기본값은 100, 최소는 1, 최대 페이지 크기는 100입니다.

page_token

string

지정하면 위치의 다음 page를 가져옵니다. 요청된 페이지 크기에 넣을 수 있는 위치보다 많은 위치가 있는 경우 이전 ListLocations 호출에서 페이지 토큰이 반환됩니다.

filter

string

반환할 위치를 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. filter가 비어 있으면 제약 조건이 적용되고 요청된 계정에 대해 모든 위치 (페이지 매김)를 가져옵니다.

유효한 입력란과 사용 예에 대한 자세한 내용은 위치 데이터 사용 가이드를 참고하세요.

language_code
(deprecated)

string

디스플레이 위치 속성을 가져올 BCP 47 언어 코드입니다. 이 언어를 사용할 수 없는 경우 해당 지역의 언어로 제공됩니다. 둘 다 사용할 수 없는 경우에는 영어로 제공됩니다.

지원이 중단되었습니다. 2020년 8월 15일 이후에는 이 필드가 더 이상 적용되지 않습니다. 대신 위치의 언어가 항상 사용됩니다.

order_by

string

요청의 정렬 순서입니다. 여러 필드는 SQL 구문에 따라 쉼표로 구분되어야 합니다. 기본 정렬 순서는 오름차순입니다. 내림차순을 지정하려면 접미사 ' desc'를 추가해야 합니다. order_by로 사용할 수 있는 유효한 필드는 location_name 및 store_code입니다. 예: 'location_name, store_code desc', 'location_name', 'store_code desc'

ListLocationsResponse

Locations.ListLocations의 응답 메시지입니다.

필드
locations[]

Location

위치입니다.

next_page_token

string

위치 수가 요청된 페이지 크기를 초과하면 이 필드는 ListLocations에 대한 후속 호출에서 다음 위치 페이지를 가져오는 토큰으로 채워집니다. 위치가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다.

total_size

int32

페이지로 나누기와 관계없이 목록에 있는 대략적인 위치 수입니다.

ListMediaItemsRequest

Media.ListMediaItems 요청 메시지입니다.

필드
parent

string

미디어 항목이 나열될 위치의 이름입니다.

page_size

int32

페이지당 반환할 미디어 항목의 수입니다. 기본값은 100이며, 이는 Google My Business API를 사용하여 위치에 추가할 수 있는 최대 미디어 항목 수이기도 합니다. 최대 페이지 크기는 2,500입니다.

page_token

string

지정하면 미디어 항목의 다음 페이지가 반환됩니다.

ListMediaItemsResponse

Media.ListMediaItems의 응답 메시지입니다.

필드
media_items[]

MediaItem

반환된 미디어 항목 목록입니다.

total_media_item_count

int32

페이지로 나누기와 관계없이 이 위치의 총 미디어 항목 수입니다.

next_page_token

string

요청된 페이지 크기보다 더 많은 미디어 항목이 있는 경우 ListMediaItems에 대한 후속 호출에서 미디어 항목의 다음 페이지를 가져오는 토큰으로 이 필드가 채워집니다.

ListQuestionsRequest

QuestionsAndAnswers.ListQuestions 요청 메시지입니다.

필드
parent

string

질문을 가져올 위치의 이름입니다.

page_size

int32

페이지당 가져올 질문 수입니다. 기본 및 최대 page_size 값은 10입니다.

page_token

string

지정하면 다음 질문 페이지가 검색됩니다.

answers_per_question

int32

질문당 가져올 답변의 수입니다. 기본 및 최대 answers_per_question 값은 10입니다.

filter

string

질문의 반환을 제한하는 필터입니다. 현재 지원되는 유일한 필터는 'ignore_answered=true'입니다.

order_by

string

질문을 반환하기 위한 순서입니다. 유효한 옵션으로는 'update_time desc'와 'upvote_count desc'가 있습니다. 이 경우 요청된 필드를 기준으로 내림차순으로 정렬된 질문이 반환됩니다. 기본 정렬 순서는 'update_time desc'입니다.

ListQuestionsResponse

QuestionsAndAnswers.ListQuestions에 대한 응답 메시지입니다.

필드
questions[]

Question

요청된 질문은

total_size

int32

모든 페이지에서 이 위치에 대해 게시된 총 질문 수입니다.

next_page_token

string

질문 수가 요청된 최대 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 질문 페이지를 가져오는 토큰으로 채워집니다. 질문이 더 이상 없으면 응답에 이 필드가 표시되지 않습니다.

ListRecommendedGoogleLocationsRequest

비즈니스 프로필 계정의 추천 위치 목록을 요청하는 메시지 요청

필드
name

string

추천 Google 위치를 가져올 계정 리소스의 이름입니다.

page_size

int32

페이지당 가져올 위치 수입니다. 기본값은 25, 최소는 1, 최대 페이지 크기는 100입니다.

page_token

string

지정하면 위치의 다음 페이지가 검색됩니다.

ListRecommendedGoogleLocationsResponse

GoogleLocations.ListRecommendedGoogleLocations의 응답 메시지입니다.

또한 이 비즈니스 프로필 계정에 마지막으로 추천된 이후 다른 비즈니스 프로필 사용자가 소유권을 주장한 일부 위치도 포함됩니다.

필드
google_locations[]

GoogleLocation

비즈니스 프로필 계정에 추천된 위치입니다. 이러한 각 요소는 지도에 있는 GoogleLocation를 나타냅니다. 위치는 비즈니스 프로필 계정과의 관련성이 높은 순서대로 정렬됩니다.

total_size

int32

페이지로 나누기와 관계없이 이 비즈니스 프로필 계정에 추천되는 총 위치 수입니다.

next_page_token

string

페이지로 나누기 중에 다음 페이지에 가져올 수 있는 위치가 더 있는 경우 후속 호출에서 다음 위치 페이지를 가져오는 토큰으로 이 필드가 채워집니다. 가져올 위치가 더 이상 없으면 이 필드는 응답에 표시되지 않습니다.

ListReviewsRequest

Reviews.ListReviews 요청 메시지입니다.

필드
parent

string

리뷰를 가져올 위치의 이름입니다.

page_size

int32

페이지당 가져올 리뷰 수입니다. 최대 page_size은 50입니다.

page_token

string

지정하면 다음 리뷰 페이지를 가져옵니다.

order_by

string

리뷰 정렬의 기준이 될 필드를 지정합니다. 지정하지 않으면 반환되는 리뷰 순서가 기본적으로 update_time desc로 설정됩니다. 정렬할 올바른 순서는 rating, rating desc, update_time desc입니다.

ListReviewsResponse

Reviews.ListReviews의 응답 메시지입니다.

필드
reviews[]

Review

리뷰입니다.

average_rating

double

이 위치에 대한 모든 리뷰의 평균 별표 평점(1~5점)으로, 5가 가장 높은 평점입니다.

total_review_count

int32

이 위치에 대한 총 리뷰 수입니다.

next_page_token

string

리뷰 수가 요청된 페이지 크기를 초과하면 이 필드는 ListReviews에 대한 후속 호출에서 다음 리뷰 페이지를 가져오는 토큰으로 채워집니다. 리뷰가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다.

ListVerificationsRequest

Verifications.ListVerifications 요청 메시지입니다.

필드
parent

string

인증 요청이 속한 위치의 리소스 이름입니다.

page_size

int32

페이지당 포함할 인증 수입니다. 설정하지 않으면 모두 반환합니다.

page_token

string

지정하면 다음 인증 페이지가 반환됩니다.

ListVerificationsResponse

Verifications.ListVerifications의 응답 메시지입니다.

필드
verifications[]

Verification

인증 목록입니다.

next_page_token

string

인증 수가 요청된 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 인증 페이지를 가져오는 토큰으로 채워집니다. 속성이 더 이상 없으면 이 필드는 응답에 표시되지 않습니다.

LocalPost

위치의 지역 게시물을 나타냅니다.

필드
name

string

출력 전용. 이 지역 게시물의 Google 식별자입니다. 형식: accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}

language_code

string

지역 게시물의 언어입니다.

summary

string

지역 게시물의 설명/본문입니다.

call_to_action

CallToAction

사용자가 프로모션을 클릭하면 연결되는 URL입니다. 주제 유형 OFFER에 대해 무시되었습니다.

create_time

Timestamp

출력 전용. 게시물 작성 시간입니다.

update_time

Timestamp

출력 전용. 사용자가 마지막으로 게시물을 수정한 시간입니다.

event

LocalPostEvent

일정 정보입니다. 주제 유형 EVENTOFFER에 필요합니다.

state

LocalPostState

출력 전용. 게시물의 수명 주기 중 어느 부분에 있는지 나타내는 게시물의 상태입니다.

media[]

MediaItem

게시물과 연결된 미디어입니다. source_url은 LocalPost MediaItem에 대해 지원되는 유일한 데이터 필드입니다.

search_url

string

출력 전용. Google 검색에 표시되는 지역 게시물 링크입니다. 이 링크는 소셜 미디어, 이메일, 텍스트 등을 통해 게시물을 공유하는 데 사용할 수 있습니다.

topic_type

LocalPostTopicType

필수 항목입니다. 게시물의 주제 유형(일반, 이벤트, 혜택, 알림)입니다.

alert_type

AlertType

게시물이 생성되는 알림의 유형입니다. 이 필드는 topic_type 알림의 게시물에만 적용되며 알림의 하위 유형으로 동작합니다.

offer

LocalPostOffer

혜택 게시물에 대한 추가 데이터입니다. topic_type이 OFFER인 경우에만 설정해야 합니다.

LocalPostState

게시물의 상태를 나타냅니다.

열거형
LOCAL_POST_STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
REJECTED 이 게시물은 콘텐츠 정책 위반으로 인해 거부되었습니다.
LIVE 이 게시물은 게시되었으며 현재 검색결과에 표시되고 있습니다.
PROCESSING 이 게시물은 처리 중이며 검색결과에 표시되지 않습니다.

LocalPostEvent

지역 게시물에 표시된 이벤트와 관련된 모든 정보입니다.

필드
title

string

이벤트 이름입니다.

schedule

TimeInterval

일정 시작 및 종료 날짜/시간

LocalPostMetrics

지역 게시물에 요청된 모든 측정항목입니다.

필드
local_post_name

string

metric_values[]

MetricValue

요청된 측정항목의 값 목록입니다.

LocalPostOffer

쿠폰 게시물의 특정 필드입니다.

필드
coupon_code

string

선택사항입니다. 매장 또는 온라인에서 사용할 수 있는 쿠폰 코드입니다.

redeem_online_url

string

선택사항입니다. 쿠폰을 사용할 수 있는 온라인 링크입니다.

terms_conditions

string

선택사항입니다. 쿠폰 이용약관입니다.

LocalPostTopicType

지역 게시물의 주제 유형으로, 게시물을 만들고 렌더링하는 다양한 템플릿을 선택하는 데 사용됩니다.

열거형
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED 지정된 게시물 유형이 없습니다.
STANDARD 게시물에 요약 및 이미지와 같은 기본 정보가 포함됩니다.
EVENT 게시물에 기본 정보와 이벤트가 포함됩니다.
OFFER 게시물에 기본 정보, 이벤트, 혜택 관련 콘텐츠 (예: 쿠폰 코드)가 포함됩니다.
ALERT 진행 중인 이벤트와 관련된 우선순위가 높고 시기적절한 공지입니다. 이러한 유형의 게시물을 항상 작성할 수 있는 것은 아닙니다.

위치

위치 이러한 입력란에 대한 자세한 설명은 고객센터 도움말을 참고하고 유효한 비즈니스 카테고리 목록은 카테고리 엔드포인트를 참고하세요.

필드
name

string

이 위치의 Google 식별자(형식: accounts/{account_id}/locations/{location_id})

일치 컨텍스트에서는 이 필드가 채워지지 않습니다.

language_code

string

위치의 언어입니다. 생성 중에 설정되며 업데이트할 수 없습니다.

store_code

string

이 위치의 외부 식별자로, 지정된 계정 내에서 고유해야 합니다. 위치를 자신의 레코드와 연결하는 방법입니다.

location_name

string

위치 이름은 오프라인 매장, 웹사이트, 회사 서간지에서 일관되게 사용되고 고객에게 알려져 있는 비즈니스의 실제 이름을 반영해야 합니다. 추가 정보는 해당하는 경우 리소스의 다른 필드 (예: Address, Categories)에 포함할 수 있습니다. 이름에 불필요한 정보를 추가하지 마세요 (예: 'Google Inc. - Mountain View Corporate 본사'보다 'Google' 선호). 마케팅 소개 문구, 판매점 코드, 특수문자, 영업시간 또는 영업 종료/영업 상태, 전화번호, 웹사이트 URL, 서비스/제품 정보, 위치/주소 또는 경로, 보관 정보를 포함하지 마세요 (예: 'Duane Reade의 체이스 ATM').

primary_phone

string

가능한 한 개별 업체 위치로 직접 연결되는 전화번호입니다. 가능하면 중앙의 콜센터 전화번호가 아닌 지역 전화번호를 사용하세요.

additional_phones[]

string

기본 전화번호 외에 비즈니스에 연락할 수 있는 전화번호 (휴대전화 또는 유선 전화번호)입니다. 최대 2개까지 추가할 수 있으며 팩스 번호는 사용할 수 없습니다.

address

PostalAddress

정확한 주소를 사용해 업체 위치를 설명하세요. 원격 위치에 있는 사서함이나 우편함은 사용할 수 없습니다. 현재는 주소에 최대 5개의 address_lines 값을 지정할 수 있습니다.

primary_category

Category

이 위치가 수행하는 핵심 비즈니스를 가장 잘 설명하는 카테고리입니다.

additional_categories[]

Category

비즈니스를 설명하는 추가 카테고리입니다. 카테고리를 지정해 두면 고객이 관심 있는 서비스를 정확하게 찾을 수 있습니다. 비즈니스 정보를 최신 상태로 정확하게 유지하려면 전체 핵심 비즈니스를 설명하는 카테고리를 가능한 한 적게 사용해야 합니다. 최대한 구체적이면서 주 비즈니스를 대표하는 카테고리를 선택하세요.

website_url

string

이 비즈니스의 URL입니다. 가능하면 모든 위치 또는 브랜드를 나타내는 일반 웹사이트/URL 대신 이 개별 업체 위치를 나타내는 URL을 사용하세요.

regular_hours

BusinessHours

비즈니스의 영업시간입니다.

special_hours

SpecialHours

비즈니스의 특별 영업시간입니다. 일반적으로 휴일 영업시간과 정규 영업시간 외의 기타 시간도 포함됩니다. 이 영업시간은 정규 영업시간보다 우선합니다.

service_area

ServiceAreaBusiness

방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다. 방문 서비스 업체인 경우, 이 필드는 업체가 서비스를 제공하는 지역을 설명합니다.

location_key

LocationKey

이 비즈니스를 Google+ 페이지, Google 지도 장소 등 다른 Google 서비스에 연결하는 키 컬렉션입니다.

labels[]

string

비즈니스에 태그를 지정할 수 있는 자유형 문자열 컬렉션입니다. 이러한 라벨은 사용자에게 표시되지 않으며 나만 볼 수 있습니다. 255자(영문 기준)로 제한됩니다(라벨당).

ad_words_location_extensions

AdWordsLocationExtensions

애드워즈에 표시되는 추가 정보입니다.

latlng

LatLng

사용자가 제공한 위도 및 경도입니다. 위치를 생성할 때 제공된 주소가 성공적으로 지오코딩되면 이 필드는 무시됩니다. 이 필드는 사용자가 제공한 latlng 값이 생성 중에 허용되었거나 latlng 값이 비즈니스 프로필 웹사이트를 통해 업데이트된 경우에만 get 요청 시 반환됩니다. 이 필드는 업데이트할 수 없습니다.

open_info

OpenInfo

위치가 현재 영업 중인지 여부를 나타내는 플래그.

location_state

LocationState

출력 전용. 위치의 상태를 반영하는 부울 집합입니다.

attributes[]

Attribute

이 위치의 속성입니다.

metadata

Metadata

출력 전용. 사용자가 수정할 수 없는 추가 정보입니다.

price_lists[]
(deprecated)

PriceList

지원 중단됨: 이 위치의 가격 목록 정보입니다.

profile

Profile

비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다.

relationship_data

RelationshipData

이 매장과 관련된 모든 매장 및 체인입니다.

more_hours[]

MoreHours

비즈니스의 여러 부서 또는 특정 고객에 대한 추가 영업시간입니다.

메타데이터

사용자가 수정할 수 없는 추가 위치 정보입니다.

필드
duplicate
(deprecated)

Duplicate

이 위치가 중복된 위치에 대한 정보입니다. location_state.is_duplicate가 true인 경우에만 존재합니다. 지원 중단됨: Google에서는 중복 항목에 관한 자세한 정보를 더 이상 지원하지 않습니다.

maps_url

string

지도상의 위치에 대한 링크입니다.

new_review_url

string

고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지의 링크입니다.

복사

이 위치가 중복된 위치에 대한 정보입니다.

필드
location_name

string

중복된 위치의 리소스 이름입니다. 인증된 사용자에게 해당 위치에 대한 액세스 권한이 있고 해당 위치가 삭제되지 않은 경우에만 채워집니다.

place_id

string

중복된 위치의 장소 ID입니다.

access

Access

중복된 위치에 사용자가 액세스할 수 있는지 여부를 나타냅니다.

액세스

중복된 위치에 대한 사용자의 액세스 수준입니다. 이 소유권은 소유권을 대체하며 대신 사용해야 합니다.

열거형
ACCESS_UNSPECIFIED 지정되지 않음
ACCESS_UNKNOWN 사용자가 중복된 위치에 액세스할 수 있는지 확인할 수 없습니다.
ALLOWED 사용자가 동일한 위치에 액세스할 수 있습니다.
INSUFFICIENT 사용자에게 중복된 위치에 액세스할 수 있는 권한이 없습니다.

RelationshipData

이 위치와 관련된 모든 상위 및 하위 위치의 정보입니다.

필드
parent_chain

string

이 위치가 속한 체인의 리소스 이름입니다. How to find Chain ID

LocationDrivingDirectionMetrics

사람들이 보통 출근하는 지역으로 색인이 생성된 위치입니다. 이는 각 지역에서 이 위치로 이동하는 운전 경로 요청 수를 계산하여 캡처합니다.

필드
location_name

string

이 측정항목 값이 속한 위치 리소스 이름입니다.

top_direction_sources[]

TopDirectionSources

소스 지역별 운전 경로 요청입니다. 규칙에 따라 최대 10개의 결과로 개수별로 정렬됩니다.

time_zone

string

위치의 시간대입니다 (IANA 시간대 ID, 예: '유럽/런던').

TopDirectionSources

운전 경로 요청이 발생한 상위 지역입니다.

필드
day_count

int32

일 수 데이터가 집계됩니다.

region_counts[]

RegionCount

지역이 개수 기준 내림차순으로 정렬됩니다.

RegionCount

연결된 요청 수가 있는 지역입니다.

필드
latlng

LatLng

리전의 중심입니다.

label

string

사람이 읽을 수 있는 리전의 라벨입니다.

count

int64

이 지역의 운전 경로 요청 수입니다.

LocationKey

위치의 대체/서로게이트 키 참조입니다.

필드
plus_page_id

string

출력 전용. 위치에 연결된 Google+ 페이지가 있는 경우 이 위치의 Google+ 페이지 ID로 채워집니다.

place_id

string

이 위치가 인증되어 Google 지도에 연결/표시되는 경우 이 필드는 위치의 장소 ID로 채워집니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다.

위치가 인증되지 않은 경우, 이 필드는 위치가 Google 지도에 표시되는 장소와 연결된 경우 채워집니다.

이 필드는 Create 호출 중에 설정할 수 있지만 Update 호출 중에는 설정할 수 없습니다.

추가 explicit_no_place_id 부울은 설정되지 않은 장소 ID가 의도적인지 여부를 한정합니다.

explicit_no_place_id

bool

출력 전용. true 값은 설정되지 않은 장소 ID가 의도적임을 나타내며, 아직 연결되지 않은 것과는 다릅니다.

request_id

string

출력 전용. 이 위치를 만드는 데 사용된 request_id입니다. 이 위치가 Google My Business API 또는 비즈니스 프로필 위치 외부에서 생성된 경우 비어 있을 수 있습니다.

LocationMetrics

일정 기간 동안 위치와 연결된 일련의 측정항목 및 BreakdownMetrics입니다.

필드
location_name

string

값이 속한 위치 리소스 이름입니다.

time_zone

string

위치의 IANA 시간대입니다.

metric_values[]

MetricValue

요청된 측정항목의 값 목록입니다.

LocationReview

위치 정보가 있는 리뷰를 나타냅니다.

필드
name

string

위치 리소스 이름입니다.

review

Review

위치에 대한 리뷰입니다.

LocationState

Location의 상태를 반영하는 부울 집합이 포함됩니다.

필드
is_google_updated

bool

출력 전용. 이 위치에 연결된 장소 ID에 업데이트가 있는지 여부를 나타냅니다.

is_duplicate

bool

출력 전용. 위치가 다른 위치와 중복되는지 여부를 나타냅니다.

is_suspended

bool

출력 전용. 위치가 정지되었는지 여부를 나타냅니다. 일시중지된 위치는 Google 제품의 최종 사용자에게 표시되지 않습니다. 실수라고 생각되면 고객센터 도움말을 참조하세요.

can_update

bool

출력 전용. 위치를 업데이트할 수 있는지 여부를 나타냅니다.

can_delete

bool

출력 전용. Google My Business API를 사용하여 위치를 삭제할 수 있는지 여부를 나타냅니다.

is_verified

bool

출력 전용. 위치가 인증되었는지 여부를 나타냅니다.

needs_reverification

bool

출력 전용. 위치에 재인증이 필요한지 여부를 나타냅니다.

is_pending_review

bool

출력 전용. 위치 검토가 대기 중인지 여부를 나타냅니다.

is_disabled

bool

출력 전용. 위치가 사용 중지되었는지 여부를 나타냅니다.

is_published

bool

출력 전용. 위치의 게시 여부를 나타냅니다.

is_disconnected

bool

출력 전용. 위치가 Google 지도의 장소와 연결 해제되었는지 여부를 나타냅니다.

is_local_post_api_disabled

bool

출력 전용. 이 위치에 accounts.locations.localPosts가 사용 중지되었는지 여부를 나타냅니다.

can_modify_service_list

bool

출력 전용. 등록정보에서 ServiceList를 수정할 수 있는지 여부를 나타냅니다.

can_have_food_menus

bool

출력 전용. 등록정보가 음식 메뉴에 적합한지 여부를 나타냅니다.

has_pending_edits

bool

출력 전용. 이 위치의 속성이 수정 대기 중 상태에 있는지 여부를 나타냅니다.

has_pending_verification

bool

출력 전용. 위치에 대기 중인 인증 요청이 있는지 여부를 나타냅니다.

can_operate_health_data

bool

출력 전용. 위치가 건강 데이터를 활용할 수 있는지를 나타냅니다.

can_operate_lodging_data

bool

출력 전용. 위치가 숙박 시설 데이터에서 운영할 수 있는지 여부를 나타냅니다.

MatchedLocation

위치와 일치할 수 있는 항목을 나타냅니다.

필드
location

Location

인구 밀도가 낮고 일치 가능성이 있는 위치입니다. 채워지지 않은 필드에는 이름 (일치하는 위치는 GetLocation 또는 BatchGetLocations을 통해 가져올 수 없음), store_code, service_area 서비스 지역 세부정보, labels, ad_words_location_extensions, photos 등이 포함되지만 이에 국한되지 않을 수 있습니다.

is_exact_match

bool

일치검색인가요?

MediaItem

단일 미디어 항목입니다.

필드
name

string

이 미디어 항목의 리소스 이름입니다. accounts/{account_id}/locations/{location_id}/media/{media_key}

media_format

MediaFormat

이 미디어 항목의 형식입니다. 미디어 항목이 생성될 때 설정해야 하며, 다른 모든 요청에서 읽기 전용입니다. 이 설정은 업데이트할 수 없습니다.

location_association

LocationAssociation

CreatePhoto를 호출할 때 필요합니다. 이 미디어 항목이 해당 위치에 연결되는 방식을 설명합니다. 카테고리 (예: EXTERIOR) 또는 가격 목록 항목의 ID여야 합니다.

CreateMediaItem를 사용하여 위치에 새 미디어를 추가할 때 필요합니다. 지역 게시물의 사진과 같은 다른 유형의 미디어에는 표시되지 않습니다.

google_url

string

출력 전용. 이 미디어 항목에 대해 Google에서 호스팅하는 URL입니다. 이 URL은 시간이 지남에 따라 변경될 수 있으므로 정적이지 않습니다. 동영상의 경우 오버레이된 재생 아이콘이 있는 미리보기 이미지입니다.

thumbnail_url

string

출력 전용. 제공되는 경우 이 미디어 항목의 미리보기 이미지 URL입니다.

create_time

Timestamp

출력 전용. 이 미디어 항목의 생성 시간입니다.

dimensions

Dimensions

출력 전용. 픽셀 단위의 크기 (너비 및 높이)입니다.

insights

MediaInsights

출력 전용. 이 미디어 항목에 대한 통계입니다.

attribution

Attribution

출력 전용. 고객 미디어 항목의 저작자 표시 정보입니다. 이 저작자 표시를 사용자에게 제공한 대로 표시해야 하며 저작자 표시를 삭제하거나 변경해서는 안 됩니다.

description

string

이 미디어 항목의 설명입니다. 설명은 Google My Business API를 통해 수정할 수 없지만 표지 사진이 아닌 새 미디어 항목을 만들 때 설정할 수 있습니다.

통합 필드 data. 미디어 항목의 데이터 소스입니다. 새 미디어 항목을 만들 때 URL 또는 데이터 참조를 제공해야 합니다.

PROFILECOVER 카테고리를 제외한 모든 사진은 짧은 쪽이 250픽셀 이상, 파일 크기가 10, 240바이트 이상이어야 합니다.

업로드된 모든 사진은 사진 관련 비즈니스 프로필 가이드라인을 준수해야 합니다. data은 다음 중 하나여야 합니다.

source_url

string

미디어 항목을 가져올 수 있는 공개적으로 액세스 가능한 URL입니다.

이 소스 중 하나를 만들거나 data_ref를 설정하여 미디어 항목의 소스를 지정해야 합니다.

미디어 항목을 만들 때 source_url를 사용한 경우 미디어 항목이 검색될 때 이 소스 URL로 채워집니다.

이 필드는 업데이트할 수 없습니다.

data_ref

MediaItemDataRef

입력 전용. StartUploadMediaItemData 메서드에서 가져온 미디어 항목 바이너리 데이터에 대한 참조입니다.

미디어 항목을 만들 때

sourceUrl

또는

dataRef

를 설정해야 합니다.

기여 분석

기여자의 이름 및 프로필 사진과 같은 고객 미디어 항목의 저작자 표시 정보입니다.

필드
profile_name

string

미디어 항목의 기여자인 사용자 이름입니다.

profile_photo_url

string

기여 사용자의 프로필 사진 미리보기 이미지 URL입니다.

takedown_url

string

부적절한 미디어 항목을 신고할 수 있는 게시 중단 페이지의 URL입니다.

profile_url

string

기여 사용자의 Google 지도 프로필 페이지 URL입니다.

크기

미디어 항목의 크기입니다.

필드
width_pixels

int32

미디어 항목의 너비(픽셀)입니다.

height_pixels

int32

미디어 항목의 높이(픽셀)입니다.

LocationAssociation

미디어 항목이 해당 위치에 연결되는 방식입니다.

필드
통합 필드 location_attachment_type. 위치 미디어에는 카테고리 또는 연결된 가격 목록 항목의 ID가 있어야 합니다. 비위치 미디어 (예: 지역 게시물 사진)에는 둘 다 없어야 합니다. location_attachment_type은 다음 중 하나여야 합니다.
category

Category

이 위치 사진이 속한 카테고리입니다.

price_list_item_id

string

이 위치 사진과 연결된 가격 목록 항목의 ID입니다.

카테고리

미디어 항목 카테고리의 열거형입니다.

열거형
CATEGORY_UNSPECIFIED 카테고리가 지정되지 않았습니다.
COVER 표지 사진입니다. 위치에는 표지 사진이 하나만 있습니다.
PROFILE 프로필 사진입니다. 위치에는 프로필 사진이 하나만 있습니다.
EXTERIOR 외부 미디어입니다.
INTERIOR 내부 미디어.
PRODUCT 제품 미디어입니다.
AT_WORK '직장' 미디어입니다.
FOOD_AND_DRINK 식음료 미디어입니다.
MENU 메뉴 미디어입니다.
COMMON_AREA 공용 시설 미디어입니다.
ROOMS 채팅방 미디어입니다.
TEAMS 팀 미디어입니다.
ADDITIONAL 분류되지 않은 추가 미디어입니다.

MediaFormat

미디어 형식의 열거형입니다.

열거형
MEDIA_FORMAT_UNSPECIFIED 형식이 지정되지 않았습니다.
PHOTO 미디어 항목이 사진입니다. 이 버전에서는 사진만 지원됩니다.
VIDEO 미디어 항목이 동영상입니다.

MediaInsights

미디어 항목에 대한 통계입니다.

필드
view_count

int64

출력 전용. 미디어 항목이 조회된 횟수입니다.

MediaItemDataRef

Google My Business API를 통해 업로드된 MediaItem의 사진 바이너리 데이터에 대한 참조입니다.

StartUploadMediaItemData를 사용하여 데이터 참조를 만들고, 바이트를 [UpdateMedia] 에 업로드한 후 CreateMediaItem를 호출할 때 이 참조를 사용합니다.

필드
resource_name

string

이 미디어 항목의 바이너리 데이터의 고유 ID입니다. [UpdateMedia] 를 사용하여 사진 데이터를 업로드하고 CreateMediaItem로 이러한 바이트에서 새 미디어 항목을 만들 때 사용됩니다.

바이트 업로드 예시: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resource_name}?upload_type=media"

CreateMediaItem 호출의 경우 MediaItem data_ref로 설정합니다.

메뉴와 메뉴의 다양한 하위 구성요소를 표시할 때 사용되는 라벨입니다.

필드
display_name

string

필수 항목입니다. 구성요소의 표시 이름입니다.

description

string

선택사항입니다. 구성요소의 추가 정보입니다.

language_code

string

선택사항입니다. BCP 47 언어 코드입니다. 언어를 사용할 수 없는 경우 영어로 기본 설정됩니다.

측정항목

리소스에 대한 데이터 측정항목입니다.

열거형
METRIC_UNSPECIFIED 지정된 측정항목이 없습니다.
ALL 사용 가능한 모든 측정항목을 요청하는 약식입니다. '전체'에 포함되는 측정항목은 다르며, 통계가 요청되는 리소스에 따라 다릅니다.
QUERIES_DIRECT 위치를 직접 검색할 때 리소스가 표시된 횟수입니다.
QUERIES_INDIRECT 카테고리 검색 (예: 식당)의 결과로 리소스가 표시된 횟수입니다.
QUERIES_CHAIN 리소스가 속한 체인이나 리소스가 판매하는 브랜드를 검색한 결과로 리소스가 표시된 횟수입니다. 예: Starbucks, 아디다스 QUERIES_INDIRECT의 하위 집합입니다.
VIEWS_MAPS 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

Metric

요청된 측정항목입니다.

options[]

MetricOption

반환될 때 값이 표시되는 방식입니다.

MetricValue

시작 시간의 단일 측정항목 값입니다.

필드
metric

Metric

값이 적용되는 측정항목입니다.

total_value

DimensionalMetricValue

이 측정항목의 총 집계 값입니다. AGGREGATED_TOTAL 옵션에 대해 설정합니다.

dimensional_values[]

DimensionalMetricValue

이 측정항목의 측정기준 값입니다.

MoreHours

특정 유형의 비즈니스에 위치가 영업하는 기간입니다.

필드
hours_type_id

string

필수 항목입니다. 시간 유형입니다. 고객은 {#link businessCategories:BatchGet}을(를) 호출하여 위치 카테고리에 대해 지원되는 시간 유형을 가져와야 합니다.

periods[]

TimePeriod

필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

MoreHoursType

정상 영업시간 외에 비즈니스에서 제공할 수 있는 추가 영업시간 유형입니다.

필드
hours_type_id

string

출력 전용. Google에서 이 영업시간 유형에 제공하는 안정적인 ID입니다.

display_name

string

출력 전용. 사람이 읽을 수 있는 시간 유형의 영어 표시 이름입니다.

localized_display_name

string

출력 전용. 사람이 읽을 수 있는 시간 유형의 현지화된 표시 이름입니다.

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

string

출력 전용. 알림 리소스 이름입니다.

topic_name

string

이 계정에서 관리하는 위치가 업데이트되면 알림을 수신할 Google Cloud Pub/Sub 주제입니다. 설정하지 않으면 알림이 게시되지 않습니다.

mybusiness-api-pubsub@system.gserviceaccount.com 계정에는 최소한 Cloud Pub/Sub 주제에 대한 게시 권한이 있어야 합니다.

notification_types[]

NotificationType

Cloud Pub/Sub 주제로 전송되는 알림 유형입니다. 최소 1개를 지정해야 합니다. 알림을 전혀 받지 않으려면 DeleteNotifications를 사용하세요.

NutritionFacts

이 메시지는 음식의 영양 성분을 나타냅니다.

필드
calories

CaloriesFact

선택사항입니다. 요리의 칼로리입니다.

total_fat

NutritionFact

선택사항입니다. 특정 음식에 대한 지방 정보입니다.

cholesterol

NutritionFact

선택사항입니다. 특정 음식의 콜레스테롤 정보입니다.

sodium

NutritionFact

선택사항입니다. 특정 음식의 나트륨 정보입니다.

total_carbohydrate

NutritionFact

선택사항입니다. 특정 음식에 대한 탄수화물 정보입니다.

protein

NutritionFact

선택사항입니다. 주어진 음식의 단백질 정보입니다.

CaloriesFact

이 메시지는 상한값 및 하한값 범위로 칼로리 정보를 표시합니다. 더 낮은 금액을 지정해야 합니다. 낮은 금액과 높은 금액은 모두 음수가 아닙니다.

필드
lower_amount

int32

필수 항목입니다. 낮은 칼로리

upper_amount

int32

선택사항입니다. 상한 칼로리

unit

EnergyUnit

필수 항목입니다. 주어진 칼로리 정보의 단위입니다.

EnergyUnit

가능한 식품 에너지 단위 (칼로리)

열거형
ENERGY_UNIT_UNSPECIFIED 에너지 단위 미지정
CALORIE 칼로리
JOULE

MassUnit

가능한 질량 단위입니다.

열거형
MASS_UNIT_UNSPECIFIED 대량 단위 미지정
GRAM Gram
MILLIGRAM 밀리그램

NutritionFact

이 메시지는 상한값과 하한값 범위로 영양 정보를 나타내며 질량 단위로 나타낼 수 있습니다. 더 낮은 금액을 지정해야 합니다. 낮은 금액과 높은 금액은 모두 음수가 아닙니다.

필드
lower_amount

double

필수 항목입니다. 영양 함량 낮음

upper_amount

double

선택사항입니다. 높은 영양 함량

unit

MassUnit

필수 항목입니다. 주어진 영양 정보의 단위입니다.

OpenInfo

비즈니스의 영업 상태와 관련된 정보입니다.

필드
status

OpenForBusiness

위치가 현재 영업 중인지 여부를 나타냅니다. 영업 종료 상태로 업데이트되지 않는 한 기본적으로 모든 위치는 영업 상태입니다.

can_reopen

bool

출력 전용. 비즈니스를 재개점할 수 있는지 여부를 나타냅니다.

opening_date

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

string

전화를 걸거나 SMS를 보낼 전화번호입니다. 지원되는 옵션에 있는 전화번호 중 하나여야 합니다.

PlaceInfo

장소 ID로 표시되는 지역을 정의합니다.

필드
name

string

장소의 현지화된 이름입니다. Scottsdale, AZ을 예로 들 수 있습니다.

place_id

string

장소의 ID입니다. 리전과 일치해야 합니다.

Places

장소 집합으로 표시되는 지역의 합집합을 정의합니다.

필드
place_infos[]

PlaceInfo

장소 ID로 표시되는 지역입니다. 최대 20개 장소로 제한됩니다.

PointRadius

특정 지점 (위도/경도) 주변의 반경입니다.

필드
latlng

LatLng

반경으로 정의된 지역의 중심을 지정하는 위도/경도입니다.

radius_km

float

지점 주변 지역의 거리입니다(킬로미터 단위).

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

string

필수 항목입니다. 가격 목록의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다.

labels[]

Label

필수 항목입니다. 언어 태그가 지정된 가격 목록 라벨입니다.

source_url

string

가격 목록을 가져온 소스 URL(선택사항)입니다. 예를 들어 메뉴 정보를 채우기 위해 자동으로 스크랩한 페이지의 URL일 수 있습니다.

sections[]

Section

필수 항목입니다. 이 가격 목록의 섹션입니다. 각 가격 목록에는 하나 이상의 섹션이 포함되어야 합니다.

라벨

가격 목록, 섹션 또는 상품을 표시할 때 사용되는 라벨입니다.

필드
display_name

string

필수 항목입니다. 가격 목록, 섹션 또는 상품의 표시 이름입니다.

description

string

선택사항입니다. 가격 목록, 섹션 또는 상품의 설명입니다.

language_code

string

선택사항입니다. 이러한 문자열이 적용되는 BCP-47 언어 코드입니다. 언어당 하나의 라벨 집합만 설정할 수 있습니다.

섹션

하나 이상의 항목을 포함하는 가격 목록 섹션입니다.

필드
section_id

string

필수 항목입니다. 섹션의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다.

labels[]

Label

필수 항목입니다. 언어 태그가 지정된 섹션 라벨입니다. 섹션 이름과 설명은 140자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

section_type

SectionType

선택사항입니다. 현재 가격 목록 섹션의 유형입니다. 기본값은 FOOD입니다.

items[]

Item

가격 목록의 이 섹션에 포함된 항목입니다.

항목

단일 목록 항목. 가격 목록에 있는 상품의 각 변형에는 자체 가격 데이터가 있는 자체 상품이 있어야 합니다.

필드
item_id

string

필수 항목입니다. 상품의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다.

labels[]

Label

필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.

price

Money

선택사항입니다. 상품의 가격입니다.

SectionType

섹션의 유형입니다.

열거형
SECTION_TYPE_UNSPECIFIED 지정되지 않음
FOOD 섹션에 음식을 나타내는 항목이 포함됩니다.
SERVICES 섹션에는 서비스를 나타내는 항목이 포함됩니다.

프로필

위치 프로필과 관련된 모든 정보입니다.

필드
description

string

본인의 목소리로 위치를 설명하는 것으로, 다른 사람이 수정할 수 없습니다.

문제

하나의 질문과 그 답변 중 일부를 나타냅니다.

필드
name

string

출력 전용. 질문의 고유한 이름입니다. accounts/*/locations/*/questions/*

author

Author

출력 전용. 질문 작성자입니다.

upvote_count

int32

출력 전용. 질문에 대한 찬성 투표 수입니다.

text

string

질문의 텍스트입니다. 단어 3개 이상을 포함해야 하며 총 길이는 10자(영문 기준) 이상이어야 합니다. 최대 길이는 4,096자(영문 기준)입니다.

create_time

Timestamp

출력 전용. 질문이 작성된 시간의 타임스탬프입니다.

update_time

Timestamp

출력 전용. 질문이 마지막으로 수정된 시간의 타임스탬프입니다.

top_answers[]

Answer

출력 전용. 질문에 대한 답변 목록으로, 찬성 투표수를 기준으로 정렬됩니다. 요청 매개변수에 따라 이 답변의 전체 목록이 아닐 수도 있습니다 (answers_per_question).

total_answer_count

int32

출력 전용. 이 질문에 대해 게시된 총 답변 수입니다.

RepeatedEnumAttributeValue

value_type이 REPEATED_ENUM인 속성의 값입니다. 이는 두 가지 값 ID 목록, 즉 설정된 (true) 목록과 설정되지 않은 (false) 목록으로 구성됩니다. 누락된 값은 알 수 없는 것으로 간주됩니다. 값을 1개 이상 지정해야 합니다.

필드
set_values[]

string

설정된 열거형 값.

unset_values[]

string

설정되지 않은 열거형 값.

ReportGoogleLocationRequest

GoogleLocation 신고를 위한 요청 메시지입니다.

필드
name

string

googleLocations/{googleLocationId} 형식의 [GoogleLocation] 리소스 이름입니다.

location_group_name

string

선택사항입니다. 이 Google 위치가 보고되는 위치 그룹의 리소스 이름으로 accounts/{account_id} 형식입니다.

report_reason_elaboration

string

선택사항입니다. 사용자가 이 위치를 신고하는 이유를 자세히 설명하기 위한 텍스트 항목입니다. 최대 길이는 512자(영문 기준)입니다.

report_reason_language_code

string

선택사항입니다. report_reason_elaboration에서 사용되는 언어의 BCP 47 코드입니다.

통합 필드 report_reason. 이 위치가 보고되는 이유입니다. 이유를 입력해야 합니다. report_reason은 다음 중 하나여야 합니다.
report_reason_bad_location

BadLocationReason

위치 자체에 문제가 있는 경우 사용자가 이 위치를 신고하는 이유입니다.

report_reason_bad_recommendation

BadRecommendationReason

권장사항과 관련된 문제인 경우 사용자가 이 위치를 신고하는 이유입니다. 이 보고서는 위치가 비즈니스 프로필 계정에 추천된 경우 유용합니다.

BadLocationReason

위치 자체의 데이터 품질에 문제가 있는 경우 위치를 보고하는 여러 가지 가능한 이유입니다.

열거형
BAD_LOCATION_REASON_UNSPECIFIED 지정되지 않음
NOT_A_LOCATION 추천 위치는 실제 위치가 아닙니다.
PERMANENTLY_CLOSED 추천된 위치는 폐업했습니다.
DOES_NOT_EXIST 추천 위치가 존재하지 않습니다.
SPAM 추천 위치는 스팸, 가짜 위치 또는 불쾌감을 주는 위치입니다.
NOT_A_BUSINESS 권장 위치는 비공개 장소 또는 집입니다.
MOVED

추천 위치가 새 위치로 이전되었습니다.

새 주소를 지정하는 report_reason_elaboration와 함께 표시되어야 합니다.

DUPLICATE 추천 위치가 다른 위치와 중복됩니다.

BadRecommendationReason

추천 품질에 문제가 있는 경우 (이 위치가 사용자에게 추천된 경우) 위치를 보고하는 여러 가지 이유입니다.

열거형
BAD_RECOMMENDATION_REASON_UNSPECIFIED 지정되지 않음
NOT_A_STORE_FRONT 권장 위치는 상점이 아닙니다.
NOT_PART_OF_SUGGESTED_CHAIN

추천 위치가 반환된 위치의 chain_display_name에서 제안된 체인에 속하지 않습니다.

올바른 체인의 이름을 지정하는 report_reason_elaboration가 함께 제공되어야 합니다.

IRRELEVANT

추천 위치가 사용자와 관련이 없습니다.

추천이 관련이 없는 이유에 대한 report_reason_elaboration가 함께 제공되어야 합니다.

ReportLocalPostInsightsRequest

Insights.ReportLocalPostInsights 요청 메시지입니다.

필드
name

string

필수 항목입니다. 통계를 가져올 위치의 이름입니다.

local_post_names[]

string

필수 항목입니다. 통계 데이터를 가져올 게시물 목록입니다. 모든 게시물은 name 필드에 이름이 지정된 위치에 속해야 합니다.

basic_request

BasicMetricsRequest

보고서에 기본 측정항목 통계를 포함하도록 요청합니다. 이 요청은 요청한 모든 게시물에 적용됩니다.

ReportLocalPostInsightsResponse

Insights.ReportLocalPostInsights의 응답 메시지입니다.

필드
name

string

local_post_metrics[]

LocalPostMetrics

이 위치에 해당하는 요청된 게시물당 하나의 항목입니다.

time_zone

string

위치의 시간대입니다 (IANA 시간대 ID, 예: '유럽/런던').

ReportLocationInsightsRequest

Insights.ReportLocationInsights 요청 메시지입니다.

필드
name

string

계정 리소스 이름입니다.

location_names[]

string

통계를 가져올 위치의 모음으로, 이름으로 지정됩니다.

basic_request

BasicMetricsRequest

보고서에 기본 측정항목 통계를 포함하도록 요청합니다.

driving_directions_request

DrivingDirectionMetricsRequest

보고서에 운전 경로 요청에 대한 통계를 포함해 달라는 요청입니다.

ReportLocationInsightsResponse

Insights.ReportLocationInsights의 응답 메시지입니다.

필드
location_metrics[]

LocationMetrics

위치별 측정항목 값의 모음입니다.

location_driving_direction_metrics[]

LocationDrivingDirectionMetrics

운전 경로 관련 측정항목의 값 모음입니다.

검토

출력 전용. 위치의 리뷰를 나타냅니다.

필드
name

string

리소스 이름입니다. 검토의 경우 accounts/{account_id}/locations/{location_id}/reviews/{review_id} 형식입니다.

review_id

string

암호화된 고유 식별자입니다.

reviewer

Reviewer

리뷰 작성자입니다.

star_rating

StarRating

리뷰의 별표 평점입니다.

comment

string

마크업이 포함된 일반 텍스트인 리뷰 본문입니다.

create_time

Timestamp

리뷰가 작성된 시간의 타임스탬프입니다.

update_time

Timestamp

리뷰가 마지막으로 수정된 시간의 타임스탬프입니다.

review_reply

ReviewReply

이 리뷰에 대한 이 위치의 답글의 소유자/관리자입니다.

리뷰 작성자

리뷰의 작성자를 나타냅니다.

필드
profile_photo_url

string

리뷰 작성자의 프로필 사진 링크입니다. is_anonymous가 false인 경우에만 채워집니다.

display_name

string

리뷰 작성자의 이름입니다. is_anonymous가 false인 경우에만 리뷰 작성자의 실제 이름으로 채워집니다.

is_anonymous

bool

리뷰 작성자가 익명 유지를 선택했는지 여부를 나타냅니다.

StarRating

5점 만점 기준의 별표 평점입니다.

열거형
STAR_RATING_UNSPECIFIED 지정되지 않음
ONE 5점 만점 중 별표 평점 1점입니다.
TWO 5점 만점 중 별표 평점 2점입니다.
THREE 5점 만점 중 별표 평점 3점입니다.
FOUR 5점 만점 중 별표 평점 4점입니다.
FIVE 최고 별표 평점입니다.

ReviewReply

리뷰에 대한 위치 소유자/관리자의 답글을 나타냅니다.

필드
comment

string

마크업이 포함된 일반 텍스트인 답글 본문입니다. 최대 길이는 4,096바이트입니다.

update_time

Timestamp

출력 전용. 답글이 마지막으로 수정된 시간의 타임스탬프입니다.

SearchChainsRequest

Locations.SearchChains의 요청 메시지입니다.

필드
chain_display_name

string

이름으로 체인을 검색합니다. 완전/부분적/퍼지/관련 쿼리가 지원됩니다. 예: 'walmart', 'wal-mart', 'walmmmart', '沃尔玛'

result_count

int32

이 쿼리에서 반환할 일치하는 체인의 최대 개수입니다. 기본값은 10입니다. 가능한 최댓값은 500입니다.

SearchChainsResponse

Locations.SearchChains의 응답 메시지입니다.

필드
chains[]

Chain

SearchChainsRequest에서 쿼리된 Chain_display_name과 일치하는 체인입니다. 일치하는 항목이 없으면 이 필드는 비어 있습니다. 결과는 관련성 순으로 나열됩니다.

SearchGoogleLocationsRequest

GoogleLocations.SearchGoogleLocations 요청 메시지입니다.

필드
result_count

int32

반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청하면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기 기능이 없습니다.

통합 필드 search_query. 검색어입니다. 위치 객체 또는 문자열 쿼리로 제공될 수 있습니다. search_query은 다음 중 하나여야 합니다.
location

Location

검색할 위치입니다. 제공된 경우 제공된 위치 세부정보와 일치하는 위치를 찾습니다.

query

string

검색할 텍스트 쿼리입니다. 쿼리 문자열의 검색결과는 정확한 위치를 제공하는 경우보다 정확도가 떨어질 수 있지만 부정확한 일치는 더 많이 제공될 수 있습니다.

SearchGoogleLocationsResponse

GoogleLocations.SearchGoogleLocations의 응답 메시지입니다.

필드
google_locations[]

GoogleLocation

지정된 요청과 일치할 가능성이 있는 GoogleLocations 모음으로, 정확성이 높은 것부터 낮은 순으로 나열됩니다.

ServiceAreaBusiness

방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다 (예: 열쇠공 또는 배관공).

필드
business_type

BusinessType

방문 서비스 업체의 type을 나타냅니다.

통합 필드 coverageArea. 비즈니스가 서비스를 제공하는 범위를 나타냅니다. coverageArea은 다음 중 하나여야 합니다.
radius

PointRadius

출력 전용. 이 비즈니스가 서비스를 제공하는 지역이 특정 지점을 중심으로 합니다.

places

Places

이 비즈니스가 서비스를 제공하는 지역이 장소의 집합을 통해 정의됩니다.

BusinessType

이 비즈니스가 고객 위치에서 현장 서비스만 제공하는지 (예: 견인 트럭) 주소와 현장 모두에서 서비스를 제공하는지 (예: 고객에게 배달도 하고 식사 공간이 있는 피자 가게)를 나타냅니다.

열거형
BUSINESS_TYPE_UNSPECIFIED 출력 전용. 지정되지 않음
CUSTOMER_LOCATION_ONLY 주변 지역 (비즈니스 주소가 아닌)에서만 서비스를 제공합니다.
CUSTOMER_AND_BUSINESS_LOCATION 비즈니스 주소 및 주변 지역에서 서비스를 제공합니다.

ServiceBusinessContext

서비스 비즈니스 인증을 위한 추가 데이터입니다.

필드
address

PostalAddress

위치의 인증 주소입니다. 인증 옵션을 더 사용하거나 엽서를 보내는 데 사용됩니다.

ServiceList

하나 이상의 서비스 항목이 포함된 서비스 목록입니다.

필드
name

string

필수 항목입니다. 이 위치의 Google 식별자(형식: accounts/{account_id}/locations/{location_id}/serviceList)

service_items[]

ServiceItem

이 서비스 목록에 포함된 서비스 항목입니다. 중복된 서비스 항목은 자동으로 삭제됩니다.

ServiceItem

단일 서비스 항목을 설명하는 메시지입니다. 판매자가 제공하는 서비스 유형을 설명하는 데 사용됩니다. 예를 들어 이발은 서비스가 될 수 있습니다.

필드
is_offered

bool

선택사항입니다. 이 필드는 판매자가 입력 서비스를 제공하는지 여부를 결정합니다.

price

Money

선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 currency_code 및 단위를 설정하는 것이 좋습니다.

통합 필드 service_item_info. 다음 필드 중 하나를 항상 설정해야 합니다. service_item_info은 다음 중 하나여야 합니다.
structured_service_item

StructuredServiceItem

이 필드는 구조화된 서비스 데이터의 케이스로 설정됩니다.

free_form_service_item

FreeFormServiceItem

이 필드는 자유 형식 서비스 데이터의 경우로 설정됩니다.

FreeFormServiceItem

판매자가 제공하는 자유 형식의 서비스를 나타냅니다. Google 구조 서비스 데이터의 일부로 노출되지 않는 서비스입니다. 판매자는 지오판매자 표시 경로를 통해 이러한 서비스의 이름을 직접 입력합니다.

필드
category_id

string

필수 항목입니다. category_idservice_type_idCategory 메시지에 제공된 가능한 조합과 일치해야 합니다.

label

Label

필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 이 필드는 입력이 맞춤 서비스 항목인 경우에만 설정해야 합니다. 표준화된 서비스 유형은 service_type_id를 통해 업데이트해야 합니다.

StructuredServiceItem

판매자가 제공하는 구조화된 서비스를 나타냅니다. 예: toilet_installation

필드
service_type_id

string

필수 항목입니다. service_type_id 필드는 Google에서 제공하는 고유 ID로, ServiceTypeMetadata에서 확인할 수 있습니다. 이 정보는 BatchGetBusinessCategories RPC 서비스에서 제공합니다.

description

string

선택사항입니다. 구조화된 서비스 항목에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.

ServiceType

비즈니스에서 제공하는 서비스 유형을 설명하는 메시지입니다.

필드
service_type_id

string

출력 전용. 이 서비스 유형의 안정적인 ID입니다 (Google에서 제공).

display_name

string

출력 전용. 사람이 읽을 수 있는 서비스 유형의 표시 이름입니다.

SpecialHourPeriod

위치의 영업시간이 정상 영업시간과 다른 경우 단일 기간을 나타냅니다. 특별 영업시간에 표시되는 범위는 24시간 미만이어야 합니다. open_timestart_dateclose_timeend_date보다 이전이어야 합니다. close_timeend_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

Date

특별 영업시간 기간이 시작되는 캘린더 날짜입니다.

open_time

string

위치가 개장하는 start_date의 실제 경과 시간으로, 24시간 ISO 8601 확장 형식으로 표시됩니다. (hh:mm) 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. is_closed이 false인 경우 지정해야 합니다.

end_date

Date

특별 영업시간 기간이 종료되는 캘린더 날짜입니다. end_date 필드가 설정되지 않으면 start_date에 지정된 날짜가 기본값입니다. 설정하는 경우 이 필드는 start_date 이후 1일 이하여야 합니다.

close_time

string

위치가 폐업할 때 end_date의 실제 경과 시간으로, 24시간 ISO 8601 확장 형식으로 표시됩니다. (hh:mm) 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. is_closed이 false인 경우 지정해야 합니다.

is_closed

bool

true인 경우 end_date, open_time, close_time는 무시되며 start_date에 지정된 날짜는 위치가 하루 종일 휴업한 것으로 처리됩니다.

SpecialHours

위치의 영업시간이 정상 영업시간과 다른 기간 집합을 나타냅니다.

필드
special_hour_periods[]

SpecialHourPeriod

비즈니스의 정규 영업시간에 대한 예외 목록입니다.

매운 정도

식품의 매운 정도입니다.

열거형
SPICINESS_UNSPECIFIED 등급 미지정
MILD 부드러운 매운맛을 나타냅니다.
MEDIUM 약간 매운맛의 표시입니다.
HOT 매운 매운의 표시입니다. 가장 매끄러운 수준입니다.

StartUploadMediaItemDataRequest

Media.StartUploadMediaItemData 요청 메시지입니다.

필드
parent

string

이 미디어 항목이 추가될 위치의 리소스 이름입니다.

TimeInterval

시간 간격입니다(해당 값 포함). 유효하려면 모든 필드가 포함되어야 합니다.

필드
start_date

Date

이 기간의 시작일입니다.

start_time

TimeOfDay

이 기간의 시작 시간입니다.

end_date

Date

이 기간의 종료일입니다.

end_time

TimeOfDay

이 기간의 종료 시간입니다.

TimePeriod

지정된 개장 날짜/시간에 시작해 지정된 종료 날짜/시간에 종료하는 비즈니스의 영업 기간을 나타냅니다. 영업 종료 시간은 시작 시간 뒤(예: 같은 날 이후 시간 또는 이후 날짜)에 와야 합니다.

필드
open_day

DayOfWeek

이 기간이 시작되는 day of the week를 나타냅니다.

open_time

string

24시간 ISO 8601 확장 형식 (hh:mm) 시간입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.

close_day

DayOfWeek

이 기간이 끝나는 day of the week를 나타냅니다.

close_time

string

24시간 ISO 8601 확장 형식 (hh:mm) 시간입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.

TimeRange

시간 범위입니다. 데이터는 범위 내에서 반개방 정수([start_time, end_time)]로 가져옵니다.

필드
start_time

Timestamp

범위 시작 (해당 값 포함)의 에포크 타임스탬프입니다.

end_time

Timestamp

범위 끝의 에포크 타임스탬프입니다 (제외).

TransferLocationRequest

Locations.TransferLocation 요청 메시지입니다.

필드
name

string

이전할 위치의 이름입니다.

to_account

string

위치를 이전할 계정 리소스의 이름입니다 (예: 'accounts/8675309').

UpdateAccountAdminRequest

AccessControl.UpdateAccountAdmin 요청 메시지입니다.

필드
name

string

업데이트할 관리자의 리소스 이름입니다.

admin

Admin

업데이트된 관리자입니다. 참고: 수정할 수 있는 필드는 role뿐입니다. 다른 모든 필드는 무시됩니다.

UpdateAccountRequest

Accounts.UpdateAccount에 대한 요청 메시지입니다.

필드
name

string

업데이트할 계정의 이름입니다.

account

Account

업데이트된 계정 정보입니다. 참고: 수정할 수 있는 필드는 account_name뿐입니다.

validate_only

bool

true인 경우 실제로 계정을 업데이트하지 않고 요청의 유효성이 검사됩니다.

UpdateFoodMenusRequest

FoodMenu.UpdateFoodMenus 요청 메시지입니다.

필드
food_menus

FoodMenus

필수 항목입니다. 업데이트된 음식 메뉴 정보입니다. 메뉴 섹션 없이 업데이트하여 메뉴를 설정 해제할 수 있습니다.

update_mask

FieldMask

선택사항입니다. 업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. 반복되는 입력란 항목은 개별적으로 업데이트할 수 없습니다. 참고: FoodMenus의 'name'은 업데이트할 수 없는 리소스 식별자입니다.

UpdateHealthProviderAttributesRequest

HealthProviderAttributes.UpdateHealthProviderAttributes 요청 메시지입니다.

필드
health_provider_attributes

HealthProviderAttributes

필수 항목입니다. 업데이트된 의료인 속성

update_mask

FieldMask

선택사항입니다. 업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. V1에는 업데이트할 assured_networks 필드만 있습니다. 나중에 더 많은 속성이 지원될 예정입니다.

UpdateLocalPostRequest

UpdateLocalPost 요청 메시지입니다.

필드
name

string

업데이트할 지역 게시물의 이름입니다.

local_post

LocalPost

업데이트된 지역 게시물 정보입니다.

update_mask

FieldMask

업데이트할 특정 필드입니다. 마스크에서 업데이트 중인 각 필드를 지정해야 합니다.

UpdateLocationAdminRequest

AccessControl.UpdateLocationAdmin 요청 메시지입니다.

필드
name

string

업데이트할 관리자의 리소스 이름입니다.

admin

Admin

업데이트된 관리자입니다. 참고: 수정할 수 있는 필드는 role뿐입니다. 다른 모든 필드는 무시됩니다.

UpdateLocationRequest

Locations.UpdateLocation 요청 메시지입니다.

필드
name

string

업데이트할 위치의 이름입니다.

location

Location

업데이트된 위치 정보입니다.

update_mask

FieldMask

업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다.

validate_only

bool

true인 경우 실제로 위치를 업데이트하지 않고 요청의 유효성이 검사됩니다.

attribute_mask

FieldMask

업데이트할 속성의 ID입니다. 마스크에 명시된 속성만 업데이트됩니다. 마스크에는 있고 위치에는 없는 속성은 삭제됩니다. 마스크가 비어 있으면 모든 속성이 업데이트됩니다.

이 필드가 설정될 때마다 update_mask는 업데이트할 필드 중 하나로 속성을 포함해야 합니다.

UpdateMediaItemRequest

Media.UpdateMediaItem 요청 메시지입니다.

필드
name

string

업데이트할 미디어 항목의 이름입니다.

media_item

MediaItem

업데이트할 미디어 항목입니다.

카테고리 또는 가격 목록 항목 ID만 업데이트할 수 있습니다.

update_mask

FieldMask

업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 수정 가능한 필드가 전달된 값으로 설정됩니다.

UpdateNotificationsRequest

Accounts.UpdateNotifications 요청 메시지입니다.

필드
name

string

알림 설정 리소스 이름입니다.

notifications

Notifications

업데이트된 알림 설정

UpdateQuestionRequest

QuestionsAndAnswers.UpdateQuestion 요청 메시지입니다.

필드
name

string

업데이트할 질문의 이름입니다.

question

Question

업데이트된 질문입니다.

UpdateReviewReplyRequest

Reviews.UpdateReviewReply 요청 메시지입니다.

필드
name

string

답글을 달 리뷰의 이름입니다.

review_reply

ReviewReply

리뷰에 대한 답글입니다. 이미 답글이 있는 경우 이전 답글을 대체합니다.

UpdateServiceListRequest

서비스 목록 업데이트 요청 메시지입니다.

필드
service_list

ServiceList

선택사항입니다. 업데이트된 서비스 목록 정보입니다. 이 필드를 비워 두면 API가 ServiceList를 삭제합니다. ServiceList가 설정된 경우 API는 원래 ServiceList를 설정된 서비스로 대체합니다.

update_mask

FieldMask

선택사항입니다. 업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. 반복되는 입력란 항목은 개별적으로 업데이트할 수 없습니다.

UpsertAnswerRequest

QuestionsAndAnswers.UpsertAnswer 요청 메시지입니다.

필드
parent

string

답변을 작성할 질문의 이름입니다.

answer

Answer

새로운 답변

UrlAttributeValue

URL이 value_type인 속성 값입니다.

필드
url

string

URL입니다.

ValidationError

클라이언트 요청의 유효성 검사 실패를 설명합니다.

필드
error_details[]

ErrorDetail

정수 오류 코드가 있는 개별 유효성 검사 실패를 자세히 설명합니다.

인증

인증은 위치에 대한 인증 시도를 나타냅니다.

필드
name

string

인증의 리소스 이름입니다.

method

VerificationMethod

확인 방법입니다.

state

VerificationState

인증 상태입니다.

create_time

Timestamp

인증이 요청된 시점의 타임스탬프입니다.

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

VerificationMethod

위치를 확인하는 메서드입니다.

통합 필드 DisplayData. 디스플레이 데이터 중 하나입니다. 데이터가 메서드와 일치해야 합니다. 상응하는 메서드에 표시 데이터가 없으면 비어 있습니다. DisplayData은 다음 중 하나여야 합니다.
phone_data

PhoneVerificationData

메서드가 PHONE_CALL 또는 SMS인 경우에만 설정합니다.

address_data

AddressVerificationData

메서드가 메일인 경우에만 설정합니다.

email_data

EmailVerificationData

메서드가 EMAIL인 경우에만 설정합니다.

AddressVerificationData

엽서를 통해 인증을 위한 데이터를 표시합니다.

필드
business_name

string

판매자의 업체 이름입니다.

address

PostalAddress

엽서를 받을 수 있는 주소입니다.

EmailVerificationData

이메일을 통한 인증을 위한 데이터를 표시합니다.

필드
domain_name

string

이메일 주소에 도메인 이름(예: foo@gmail.com의 'gmail.com')

user_name

string

이메일 주소의 사용자 이름(예: foo@gmail.com의 'foo')

is_user_name_editable

bool

클라이언트가 다른 사용자 이름을 제공할 수 있는지 여부입니다.

PhoneVerificationData

전화 통화, SMS 등 전화를 통한 인증을 위한 데이터 표시

필드
phone_number

string

PIN을 받을 전화번호입니다.

VerifyLocationRequest

Verifications.VerifyLocation 요청 메시지입니다.

필드
name

string

확인할 위치의 리소스 이름입니다.

method

VerificationMethod

확인 방법입니다.

language_code

string

인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다.

context

ServiceBusinessContext

서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에 필수입니다. ADDRESS 인증의 경우 엽서를 발송할 때 주소가 사용됩니다. 다른 메서드의 경우 FetchVerificationOptions에 전달되는 것과 동일해야 합니다. INVALID_ 이는 다른 유형의 업체 위치에 대해 설정된 경우 발생합니다.

통합 필드 RequestData. 표시 데이터 외에 특정 방식에 대한 사용자 입력 데이터입니다. 데이터가 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. RequestData은 다음 중 하나여야 합니다.
email_input

EmailInput

EMAIL 방법에 대한 입력입니다.

address_input

AddressInput

ADDRESS 메서드의 입력입니다.

phone_input

PhoneInput

PHONE_CALL/SMS 메서드에 대한 입력

VerifyLocationResponse

Verifications.VerifyLocation의 응답 메시지입니다.

필드
verification

Verification

생성된 인증 요청