Twórz posty w Google

Interfejs API Google Moja Firma umożliwia tworzenie postów w wyszukiwarka Google w kilku kategoriach, takich jak wiadomości, wydarzenia czy oferty;

Z tego samouczka dowiesz się, jak:

.

Zanim zaczniesz

Aby używać interfejsu API Google Moja Firma, musisz zarejestrować swoją aplikację i uzyskać dane logowania OAuth 2.0.

Aby dowiedzieć się, jak zacząć korzystać z interfejsu API Google Moja Firma, przeczytaj artykuł Podstawy

Wpisy o wydarzeniach

Powiadom klientów o nadchodzącym wydarzeniu w Twojej firmie we wpisie. Twoje Posty związane z wydarzeniem zawierają daty i godziny rozpoczęcia i zakończenia, które zawierają być dobrze widoczne w poście.

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

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 w wezwaniu do działania jest określany przez pole actionType posta. Link do podany przez użytkownika zostanie dodany do przycisku.

Aby utworzyć posta z przyciskiem z wezwaniem do działania, wykonaj te czynności:

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ą typ wezwania do działania w poście.

Oto obsługiwane typy wezwań do działania:

Typy działań
BOOK Tworzy post z prośbą o zarezerwowanie spotkania, stolika lub lub podobnego.
ORDER Tworzy posta z prośbą o złożenie zamówienia przez użytkownika.
SHOP Tworzy post z prośbą o przeglądanie produktu katalogu.
LEARN_MORE Tworzy post z prośbą o zapoznanie się z dodatkowymi informacjami na temat witryny.
SIGN_UP Tworzy post z prośbą o zarejestrowanie użytkownika lub dołączenie do niego coś.
CALL Tworzy posta z prośbą o zadzwonienie do firmy.

Wpisy o ofertach

Aby utworzyć wpis o ofercie, wykonaj te czynności:

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ć, prosząc o PATCH.

Aby edytować posta, użyj tych metod:

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ąć, wysyłając prośbę o zgodę na DELETE.

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

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