Twórz posty w Google

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

W tym samouczku pokazujemy, jak:

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu Google Moja Firma API, musisz zarejestrować swoją aplikację i uzyskać dane uwierzytelniające OAuth 2.0.

Więcej informacji o tym, jak zacząć korzystać z interfejsu Google My Business API, znajdziesz w artykule o podstawowej konfiguracji.

Wpisy o wydarzeniach

Powiadom klientów o następnym wydarzeniu w Twojej firmie za pomocą wpisu. Twój post o wydarzeniu zawiera daty i godziny rozpoczęcia i zakończenia, które są wyraźnie widoczne we wpisie.

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

Aby utworzyć posta 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

Posty z wezwaniem do działania zawierają przycisk. Tekst na przycisku z wezwaniem do działania jest określany w polu actionType posta. Do przycisku zostanie dodany link do adresu URL podanego przez użytkownika.

Aby utworzyć wpis 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ń

Wezwanie do działania w sekcji „Posty” może mieć różne typy działań, które określają ich rodzaj.

Obsługiwane typy wezwań do działania:

Typy działań
BOOK Tworzy posta z prośbą o umówienie się na spotkanie, stolik itp.
ORDER Tworzy posta, który zachęca użytkownika do zamówienia.
SHOP Tworzy posta, który zachęca użytkownika do przeglądania katalogu produktów.
LEARN_MORE Tworzy posta z prośbą o zapoznanie się z dodatkowymi informacjami na stronie internetowej.
SIGN_UP Tworzy posta, który zachęca użytkownika do zarejestrowania się, zarejestrowania lub dołączenia do czegoś.
CALL Tworzy posta z prośbą o zadzwonienie do firmy.

Wpisy z ofertami specjalnymi

Aby utworzyć wpis z ofertą, użyj tych elementów:

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

Edytuj posty

Po utworzeniu posta możesz go edytować, przesyłając prośbę o PATCH.

Aby edytować posta:

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

Usuń posty

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

Aby usunąć posta:

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