Создание публикаций в 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",
    }
  ],
  "topicType": "EVENT"
}

Публикации с призывами к действию

В публикациях с призывами к действию содержится кнопка с текстом, указанным в поле 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",
    }
  ],
  "topicType": "OFFER"
}

Типы действий

От типа действия, к которому призывает публикация, зависит тип самой публикации.

Вот список поддерживаемых типов призывов к действию:

Типы действий
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",
    }
  ],
  "topicType": "OFFER"
}

Редактирование публикаций

Если публикация уже создана, ее можно изменить с помощью запроса 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}