Tworzenie postów w Google

Interfejs API Google Moja Firma umożliwia tworzenie wpisów w wyszukiwarce Google w kilku kategoriach, takich jak wiadomości, wydarzenia i oferty.

Z tego samouczka dowiesz się, jak:

Zanim zaczniesz

Zanim użyjesz interfejsu Google Moja Firma API, musisz zarejestrować aplikację i uzyskać poświadczenia OAuth 2.0.

Szczegółowe informacje o tym, jak zacząć korzystać z interfejsu Google My Business API, znajdziesz w artykule Konfiguracja podstawowa.

Wpisy o wydarzeniach

Poinformuj klientów o najbliższym wydarzeniu w Twojej firmie za pomocą posta. Twój post dotyczący wydarzenia zawiera daty i godziny rozpoczęcia oraz zakończenia, które są wyraźnie widoczne na Post.

Aby opublikować wiadomość na koncie powiązanym z użytkownikiem, użyj interfejsu API accounts.locations.localPosts.

Aby utworzyć post dla uwierzytelnionego użytkownika, wykonaj te czynności:

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"
}

Posty z wezwaniem do działania

Wpisy z wezwaniem do działania zawierają przycisk. Tekst na przycisku wezwania do działania jest określany przez pole actionType w poście. Do przycisku jest dodawany link do adresu URL podanego przez użytkownika.

Aby utworzyć post z przyciskiem wezwania do działania:

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"
}

Typy działań

Wpisy z wezwaniem do działania mogą mieć różne typy wezwań do działania, które określają typ wpisu.

Obsługiwane są te typy wezwań do działania:

Typy działań
BOOK Tworzy post, który zachęca użytkownika do zarezerwowania spotkania, stolika lub czegoś podobnego.
ORDER Tworzy post, który zachęca użytkownika do złożenia zamówienia.
SHOP Tworzy post, który zachęca użytkownika do przeglądania katalogu produktów.
LEARN_MORE Tworzy post, który zachęca użytkownika do wyświetlenia dodatkowych informacji w witrynie.
SIGN_UP Tworzy post, który zachęca użytkownika do rejestracji, założenia konta lub dołączenia do czegoś.
CALL Tworzy post, który zachęca użytkownika do skontaktowania się z firmą.

Wpisy o ofertach

Aby utworzyć post z ofertą:

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"
}

Edytowanie postów

Po utworzeniu posta możesz go edytować za pomocą żądania PATCH.

Aby edytować post, wykonaj te czynności:

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

Usuwanie postów

Po utworzeniu posta możesz go usunąć, wysyłając prośbę DELETE.

Aby usunąć Post, wykonaj te czynności:

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