Tworzenie postów w Google

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

Z tego samouczka dowiesz się, jak:

Zanim zaczniesz

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

Więcej informacji o tym, jak zacząć korzystać z interfejsu API Google Moja Firma, znajdziesz w artykule Podstawowa konfiguracja.

Posty o wydarzeniach

Informuj klientów o kolejnym wydarzeniu w Twojej firmie za pomocą posta. Post o wydarzeniu zawiera datę i godzinę rozpoczęcia oraz zakończenia, które są wyraźnie widoczne.

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

Aby utworzyć posta dla uwierzytelnionego użytkownika, użyj tego:

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 wezwania do działania jest określany przez pole actionType posta. Do przycisku dodawany jest link do adresu URL podanego przez użytkownika.

Aby utworzyć posta z przyciskiem wezwania do działania, użyj tego:

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ń

Posty z wezwaniem do działania mogą mieć różne typy działań, które określają rodzaj posta.

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

Typy działań
BOOK Tworzy posta, który zachęca użytkownika do zarezerwowania wizyty, stolika lub czegoś podobnego.
ORDER Tworzy posta, który zachęca użytkownika do zamówienia czegoś.
SHOP Tworzy posta, który zachęca użytkownika do przeglądania katalogu produktów.
LEARN_MORE Tworzy posta, który zachęca użytkownika do wyświetlenia dodatkowych informacji na stronie internetowej.
SIGN_UP Tworzy posta, który zachęca użytkownika do zarejestrowania się, zapisania się lub dołączenia do czegoś.
CALL Tworzy posta, który zachęca użytkownika do zadzwonienia do firmy.

Posty o ofertach

Aby utworzyć posta o ofercie, użyj tego:

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ć posta, użyj tego:

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ąć za pomocą żądania DELETE.

Aby usunąć posta, użyj tego:

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