변경 로그

v4.9

새로운 기능

MoreHours
이제 MoreHours를 비즈니스 정보의 일부로 설정할 수 있습니다.
categories.batchGet을 사용하여 각 카테고리에 대해 MoreHourTypes를 가져올 수 있습니다.

동작 변경사항

v4.x 계정 지원 중단
Google My Business API에서 accounts, accounts.admins, accounts.invitations, accounts.locations.admins에 대한 지원이 중단되었습니다. 자세한 내용은 지원 중단 변경 로그를 참고하세요.
CallToAction 게시물
2021년 2분기부터는 GET_OFFER ActionType의 CallToAction 게시물을 더 이상 사용할 수 없습니다.

v4.8

새로운 기능

숙소 편의시설
숙소 편의시설을 가져오고 업데이트합니다. 추가 정보
숙박시설에 대한 GetGoogleUpdated 엔드포인트가 추가되었습니다.
LocationState에 canOperateLodgingData 부울 값이 추가되었습니다.
의료 서비스 제공업체 속성
HealthProviderAttributes를 가져오고 업데이트합니다. 추가 정보
LocationState에 canOperateHealthData 부울 값이 추가되었습니다.
보험사 네트워크
위치별로 허용되는 보험사 네트워크를 표시합니다. 추가 정보

동작 변경사항

리뷰 ID
리뷰 ID가 새 형식으로 이전되었습니다. 이제 모든 해당 API 응답에서 새 ID가 반환됩니다. 당분간은 API를 호출할 때 이전 리뷰 ID가 계속 반환되지만, Google 정책에서 요구하는 대로 listReviews 엔드포인트를 호출하여 30일 이내에 시스템에 저장된 모든 리뷰 ID를 갱신해야 합니다.
방문 서비스 업체
2021년 1분기부터는 CUSTOMER_LOCATION_ONLY 비즈니스의 Location 객체에서 Address가 더 이상 반환되지 않습니다.

v4.7

새로운 기능

음식 메뉴
FoodMenus를 가져오고 업데이트합니다. 추가 정보

v4.6

새로운 기능

서비스 목록
이제 비즈니스에서 제공하는 서비스를 가져오고 업데이트할 수 있습니다. 추가 정보
LocationState에 canModifyServiceList 부울 값 추가
위치에서 서비스 목록을 수정할 수 있는지 여부를 나타냅니다. 추가 정보
카테고리의 사전 정의된 ServiceTypes
이제 사전 정의된 서비스 유형이 카테고리 객체에 포함됩니다. 추가 정보
CategoryView
카테고리에 BASIC 또는 FULL 보기를 지정할 수 있습니다. FULL 보기는 서비스 유형과 같은 추가 세부정보를 반환합니다. 추가 정보
Categories.BatchGet 메서드
이 새로운 메서드를 사용하면 카테고리 목록을 입력하고 해당 카테고리에 관한 정보만 반환할 수 있습니다. 추가 정보

v4.5 코로나19 업데이트 2

새로운 기능

코로나19 알림 게시물 유형
이제 API를 통해 COVID_19 게시물을 만들 수 있습니다. 추가 정보

v4.5 코로나19 업데이트 1

새로운 기능

임시 휴업
이제 API를 통해 비즈니스를 CLOSED_TEMPORARILY 상태로 설정할 수 있습니다. 추가 정보

v4.5

새로운 기능

Q&A 관련 Pub/Sub
위치와 관련하여 새롭게 추가되거나 업데이트된 질문과 답변에 관한 Google Cloud Pub/Sub 알림을 받을 수 있게 되었습니다. 추가 정보
비즈니스 정보 상태 관련 Pub/Sub
비즈니스 정보 상태 변경에 관한 Google Cloud Pub/Sub 알림을 받을 수 있게 되었습니다. 추가 정보

v4.4

새로운 기능

지역 서비스 비즈니스 인증
이제 API로 지역 서비스 비즈니스를 인증할 수 있습니다. 추가 정보
팔로어 수
팔로어에 관한 메타데이터를 가져올 수 있게 되었습니다. 추가 정보
사용자 그룹 및 위치 그룹
이제 API를 통해 사용자 그룹과 위치 그룹을 만들 수 있습니다. 추가 정보
LocationState에 hasPendingEdits 필드 추가
위치의 속성이 수정 대기 중 상태인지 여부를 나타냅니다. 추가 정보

동작 변경사항

영업 개시일
이제 비즈니스 정보에 향후 영업 개시일을 설정할 수 있습니다.
PointRadius
PointRadius는 읽기 전용이 되었습니다. 지역 서비스 비즈니스를 수정하거나 만들려면 Places를 사용해야 합니다.

v4.3

새로운 기능

Questions and Answers API
질문을 가져오고 답변을 게시하며 비즈니스 위치에 관해 자주 묻는 질문(FAQ)을 제공합니다. 추가 정보
리뷰 일괄 읽기
한 번의 호출로 여러 위치의 리뷰를 가져옵니다. 추가 정보
추천된 GoogleLocations
소유권 주장이 제기되지 않았으나 Google에서 사용자의 소유라고 판단하는 위치를 확인합니다. 추가 정보
GoogleLocation 문제 신고
RecommendedGoogleLocations 또는 GoogleLocations 결과에 따라 문제를 신고합니다. 추가 정보
PriceList 섹션의 서비스 열거형
포함된 FOOD 항목 또는 제공된 SERVICES로 PriceList 섹션을 식별합니다. 추가 정보
미디어 설명
새 미디어를 업로드할 때 자막을 제공합니다. 추가 정보
CHAINS_QUERIES 통계
위치가 해당 위치가 속한 체인의 검색결과로 표시된 횟수를 가져옵니다. 추가 정보

동작 변경사항

조직 계정 및 위치 그룹에 관한 알림
Pub/Sub 알림을 사용할 수 있도록 구성된 계정에서도 해당 계정이 관리자인 조직 계정 또는 위치 그룹에 포함된 비즈니스 정보에 관한 알림을 받게 됩니다.
조직 계정 및 위치 그룹의 ListLocations
사용자 그룹 또는 조직 계정으로 호출한 accounts.locations.list가 이제 해당 계정에서 액세스할 수 있는 모든 위치를 표시합니다.

v4.2

새로운 기능

Verification API
인증되지 않은 위치에 사용할 수 있는 인증 방법을 나열하고 트리거합니다. 추가 정보
GoogleLocations API
Google에서 기존 위치를 검색하여 소유권을 주장하거나 링크를 검색하여 소유권 주장이 제기된 위치의 액세스 권한을 요청합니다. 추가 정보
확장된 위치 필터
Locations.List 호출에서 반환되는 결과를 제한하기 위한 추가 옵션입니다. 추가 정보
체인 멤버십
위치의 멤버십을 체인(예: Walmart, Target)의 일부로 표시합니다. 추가 정보
조직 정보
이제 조직 계정의 정보가 계정 객체의 일부로 표시됩니다. 추가 정보
리뷰 작성자 프로필 사진
리뷰 작성자의 프로필 사진 URL이 이제 리뷰 객체에 포함됩니다. 추가 정보

v4.1

새로운 기능

고객 제공 미디어
이제 직접 소유하고 관리하는 위치의 사용자 제작 사진과 동영상에 관한 통계를 가져와서 확인할 수 있습니다. 추가 정보
Admin Management API
이제 계정 및 계정의 위치 관련 초대를 나열, 수락, 거절할 수 있습니다. 추가 정보
Profile(판매자 제공 설명)
비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다. 추가 정보
openingDate 필드
위치에서 영업을 시작한 날짜를 제공합니다. 추가 정보
제공 유형 게시물
사용자가 위치에서 제공되는 특가 상품을 찾을 수 있도록 도와주는 Google 포스트의 새로운 유형입니다. 추가 정보

v4

새로운 기능

Google 포스트
이제 API를 통해 Google 포스트를 직접 만들 수 있습니다.
사진 업로드
이제 기존 URL 업로드 외에도 API를 통해 사진을 직접 업로드할 수 있습니다.
알림 필터링/수신 동의
이제 Pub/Sub 주제로 전송되는 알림을 필터링할 수 있습니다. 이후 알림은 이 메커니즘을 사용하여 모든 사용자에게 전송되지 않고 수신 동의에 따라 전송됩니다.
UPDATED_REVIEW 알림
이제 업데이트된 고객 리뷰에 대한 실시간 알림을 구독할 수 있습니다.
사용자 그룹 지원
Google My Business API에서 이제 사용자 그룹 유형 계정을 지원합니다.

이전 버전과 호환되지 않는 변경사항

  • 이전에는 location 객체의 필드였던 사진이 이제 위치 아래에 있는 리소스(accounts/account_ID/locations/location_ID/photos)입니다.

  • 주소 필드 Country가 이제 region_code이고, sub_locality가 이제 sublocality입니다.

  • 이전에 지원 중단된 Ownership 필드가 삭제되었습니다.

  • 이전에는 API를 통해 계정 및 위치의 공동 소유자와 기본 소유자를 구분할 수 없었습니다(모두 OWNER로 표시됨). 이제 기본 소유자에게는 OWNER 역할이 부여되고 다른 소유자에게는 CO_OWNER 역할이 부여됩니다.

  • AccountType.BUSINESS의 이름이 이제 AccountType.LOCATION_GROUP으로 지정되었습니다.

  • 위치 업데이트에 필드 마스크를 사용하는 경우 기존 field_mask 대신 update_mask를 제공합니다.

  • primary_category 및 additional_categories에 사용되는 카테고리 메시지에 더 이상 사람이 읽을 수 있는 형식이 포함되지 않습니다. 사용자는 Google My Business API의 카테고리 서비스를 사용하여 사람이 읽을 수 있게 번역된 카테고리 이름을 가져와야 합니다.

v3.3

새로운 기능

구조화된 메뉴

이제 다음을 추가, 업데이트 또는 삭제할 수 있습니다.

  • 특정 위치의 여러 메뉴

  • 메뉴 안에 여러 메뉴 섹션 포함

  • 이름, 설명, 가격, 사진이 포함된 메뉴 항목 나열

v3.2

새로운 기능

통계
이제 API를 통해 위치 통계와 운전 측정항목을 가져올 수 있습니다.
알림
이제 새 Google 업데이트의 실시간 알림을 구독할 수 있습니다.

이전 버전과 호환되지 않는 변경사항

  • 이전에 사용되지 않은 UrlAttributeValue의 languageCodes 및 platforms 필드가 삭제되었습니다.

  • 지원 중단된 소유권 열거형의 SAME은 이제 중복된 위치의 기본 소유자가 동일할 경우에만 적용됩니다. 이전에는 더 복잡한 소유권 계산을 기반으로 동작했습니다.

v3.1

새로운 기능

알림
이제 새 리뷰의 실시간 알림을 구독할 수 있습니다.
지도 URL
사용자가 Google 지도에 쉽게 연결할 수 있도록 Google 지도 URL이 위치 응답에 포함됩니다.
위치 상태
비즈니스 정보가 게시, 사용 중지, 인증 대기 중임을 나타내는 추가 위치 상태입니다.
재개장 플래그
canReopen 플래그는 폐업한 위치 중 재개장 가능한 위치와 불가능한 위치를 표시합니다.
속성
URL 및 열거형 속성을 지원합니다.
카테고리 엔드포인트
국가와 언어별로 지원되는 카테고리 목록을 가져옵니다(CSV 파일 대체).

v3

새로운 기능

리뷰
이제 API를 통해 비즈니스 리뷰를 가져오고 이에 응답할 수 있습니다.
속성
위치와 관련된 카테고리별 추가 정보를 제공합니다.
일치하는 위치 찾기
기존 지도 위치를 찾아서 직접 비즈니스 위치와 연결합니다.
위치 이전
Location :transfer의 새로운 작업입니다. 한 계정(비즈니스 또는 개인용)에서 다른 계정으로 위치를 이전할 수 있습니다.
선호하는 사진
Google 지도 및 검색에 먼저 표시되었으면 하는 사진을 표시합니다.
새 검색 필터
새 검색 필터에는 any_google_updates, is_suspended, is_duplicate가 포함됩니다.
새 위치 상태
이제 위치 상태에 is_verified 및 needs_reverification도 포함됩니다.
사진 URL 개선
API에서 이제 이미지 형식 접미사가 없는 사진 URL도 허용됩니다.

이전 버전과 호환되지 않는 변경사항

  • 이제 Google+ 페이지가 있는 위치에만 사진을 업데이트할 수 있습니다(이전에는 수락된 후 자동으로 삭제됨).

  • location_name 및 category_name 필드는 이제 출력 전용입니다. 카테고리를 설정할 때는 카테고리 ID만 사용합니다.

  • 필드 마스크에는 포함된 필드의 location. 접두사가 더 이상 포함되지 않습니다.

  • 생성/업데이트 작업은 이제 위치를 본문 페이로드로 가져오며 다른 매개변수는 쿼리 문자열로 이동합니다.

v2

이전 버전과 호환되지 않는 변경사항

  • 이제 CreateLocation 호출에서 request_id를 지정해야 합니다. 이 ID는 각 위치별로 고유해야 하므로 계정에서 중복 위치가 생성되지 않도록 방지하는 데 도움이 됩니다. 요청 ID가 이전에 생성된 위치와 일치하는 위치를 만들려고 하면 기존 위치만 반환되며 계정에서 중복 항목을 생성하지 않습니다.

    • Location의 business_hours 이름이 regular_hours로 변경되었습니다.