주의: 이제 체인에서 코로나19 관련 소식을 게시하는 것이 임시 허용됩니다. 또한 Google 마이 비즈니스는 현재 제한된 기능으로 운영되고 있습니다. 일시적인 제품 변경사항에 대해 자세히 알아보기

Google에서 게시물 작성

Google My Business API는 뉴스, 이벤트, 쿠폰과 같은 Google 검색의 여러 카테고리 내에서 게시물을 작성할 수 있는 기능을 제공합니다.

이 가이드에서는 다음 작업을 처리하는 방법을 보여줍니다.

시작하기 전에

Google My Business API를 사용하기 전에 애플리케이션을 등록하고 OAuth 2.0 사용자 인증 정보를 획득해야 합니다.

Google My Business API를 시작하는 방법에 관한 자세한 내용은 기본 설정을 참고하세요.

이벤트 게시물

게시물로 고객에게 다음 이벤트에 대해 알리세요. 이벤트 게시물에는 시작일과 종료일, 시간을 추가하고 눈에 잘 띄도록 표시하세요.

사용자와 연결된 계정에 게시물을 올리려면 accounts.locations.localPosts API를 사용하세요.

인증된 사용자를 대상으로 게시물을 만들려면 다음 코드를 사용하세요.

HTTP
$ 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",
    }
  ],
}

클릭 유도문안 게시물

클릭 유도 문안이 있는 게시물에는 버튼이 포함됩니다. 클릭 유도문안 버튼의 텍스트는 게시물의 actionType 필드에 따라 결정됩니다. 사용자가 제공한 URL의 링크가 버튼에 추가됩니다.

클릭 유도문안 버튼이 있는 게시물을 만들려면 다음 코드를 사용하세요.

HTTP
$ 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",
    }
  ],
}

작업 유형

클릭 유도 문안 게시물에는 클릭 유도문안 게시물의 유형을 결정하는 다양한 작업 유형을 포함할 수 있습니다.

다음은 지원되는 클릭 유도문안 유형입니다.

작업 유형
BOOK 사용자가 약속, 테이블 또는 유사한 항목을 예약하도록 유도하는 게시물을 만듭니다.
ORDER 사용자의 주문을 유도하는 게시물을 만듭니다.
SHOP 사용자가 제품 카탈로그를 둘러보도록 유도하는 게시물을 만듭니다.
LEARN_MORE 사용자가 웹사이트에서 추가 세부정보를 확인하도록 유도하는 게시물을 만듭니다.
SIGN_UP 사용자의 등록, 가입, 참여를 유도하는 게시물을 만듭니다.
CALL 사용자가 비즈니스에 전화를 걸도록 유도하는 게시물을 만듭니다.

쿠폰 게시물

쿠폰 게시물을 만들려면 다음 코드를 사용하세요.

HTTP
$ 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",
    }
  ],
}

게시물 수정

게시물이 생성되면 PATCH 요청을 사용하여 수정할 수 있습니다.

게시물을 수정하려면 다음 코드를 사용하세요.

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

게시물 삭제

게시물이 생성된 후 DELETE 요청을 사용하여 삭제할 수 있습니다.

게시물을 삭제하려면 다음 코드를 사용하세요.

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}