Google My Business API는 뉴스, 이벤트, 쿠폰과 같은 Google 검색의 여러 카테고리 내에서 게시물을 작성할 수 있는 기능을 제공합니다.
이 가이드에서는 다음 작업을 처리하는 방법을 보여줍니다.
- 이벤트 게시물 만들기
- 클릭 유도 문구 게시물 만들기
- 혜택 게시물 만들기
- 게시물 수정
- 게시물 삭제
시작하기 전에
Google My Business API를 사용하기 전에 애플리케이션을 등록하고 OAuth 2.0 사용자 인증 정보를 획득해야 합니다.
Google My Business API를 시작하는 방법에 관한 자세한 내용은 기본 설정을 참고하세요.
이벤트 게시물
게시물로 고객에게 다음 이벤트에 대해 알리세요. 이벤트 게시물에는 시작일과 종료일, 시간을 추가하고 눈에 잘 띄도록 표시하세요.
사용자와 연결된 계정에 게시물을 올리려면
accounts.locations.localPosts
API를 사용하세요.
인증된 사용자를 대상으로 게시물을 만들려면 다음 코드를 사용하세요.
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
클릭 유도 문구 게시물
클릭 유도 문안이 있는 게시물에는 버튼이 포함됩니다. 클릭 유도 문구 버튼의
텍스트는 게시물의 actionType
필드에 따라 결정됩니다. 사용자가 제공한
URL의 링크가 버튼에 추가됩니다.
클릭 유도 문구 버튼이 있는 게시물을 만들려면 다음 코드를 사용하세요.
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
작업 유형
클릭 유도 문안 게시물에는 클릭 유도 문구 게시물의 유형을 결정하는 다양한 작업 유형을 포함할 수 있습니다.
다음은 지원되는 클릭 유도 문구 유형입니다.
작업 유형 | |
---|---|
BOOK |
사용자가 약속, 테이블 또는 유사한 항목을 예약하도록 유도하는 게시물을 만듭니다. |
ORDER |
사용자의 주문을 유도하는 게시물을 만듭니다. |
SHOP |
사용자가 제품 카탈로그를 둘러보도록 유도하는 게시물을 만듭니다. |
LEARN_MORE |
사용자가 웹사이트에서 추가 세부정보를 확인하도록 유도하는 게시물을 만듭니다. |
SIGN_UP |
사용자의 등록, 가입, 참여를 유도하는 게시물을 만듭니다. |
CALL |
사용자가 비즈니스에 전화를 걸도록 유도하는 게시물을 만듭니다. |
쿠폰 게시물
쿠폰 게시물을 만들려면 다음 코드를 사용하세요.
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
게시물 수정
게시물이 생성되면 PATCH
요청을 사용하여 수정할 수 있습니다.
게시물을 수정하려면 다음 코드를 사용하세요.
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
게시물 삭제
게시물이 생성된 후 DELETE
요청을 사용하여 삭제할 수 있습니다.
게시물을 삭제하려면 다음 코드를 사용하세요.
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}