REST Resource: accounts.locations.localPosts

Zasób: LocalPost

Reprezentuje post lokalny dotyczący lokalizacji.

Zapis JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
Pola
name

string

Tylko dane wyjściowe. Identyfikator Google dla tego posta lokalnego w formacie: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Język posta.
summary

string

Opis/treści lokalnego posta.
callToAction

object (CallToAction)

Adres URL, na który trafiają użytkownicy po kliknięciu promocji. Ignorowana w przypadku tematu typu OFFER.
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia posta.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas ostatniej modyfikacji posta przez użytkownika.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informacje o wydarzeniach. Wymagane dla tematów EVENT i OFFER.
state

enum (LocalPostState)

Tylko dane wyjściowe. Stan posta wskazujący, w jakiej części cyklu życia się znajduje.
media[]

object (MediaItem)

Multimedia powiązane z postem. sourceUrl to jedyne obsługiwane pole danych dla elementu LocalPost MediaItem.
searchUrl

string

Tylko dane wyjściowe. Link do lokalnego posta w wyszukiwarce Google. Możesz użyć tego linku do udostępnienia posta w mediach społecznościowych, e-mailu, SMS-ie itp.
topicType

enum (LocalPostTopicType)

Wymagane. Rodzaj tematu posta: standardowy, wydarzenie, oferta lub alert.
alertType

enum (AlertType)

Typ alertu, dla którego tworzony jest post. To pole ma zastosowanie tylko do postów typu Alert typu topic i działa jako podtyp Alerty.
offer

object (LocalPostOffer)

Dodatkowe dane dotyczące postów na temat ofert. Należy go ustawić tylko wtedy, gdy topicType ma wartość OFFER.

CallToAction

Działanie wykonywane, gdy użytkownik kliknie post.

Zapis JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Pola
actionType

enum (ActionType)

Typ działania, które zostanie wykonane.
url

string

Adres URL, na który użytkownik zostanie przekierowany po kliknięciu. To pole powinno być nieskonfigurowane w przypadku wezwania do działania.

ActionType

Typ działania, które zostanie wykonane.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED Nie określono typu.
BOOK Ten post wymaga, aby użytkownik zarezerwował spotkanie, stół itp.
ORDER W tym poście użytkownik chce coś zamówić.
SHOP Ten post zachęca użytkownika do przeglądania katalogu produktów.
LEARN_MORE Ten post oczekuje od użytkownika dodatkowych informacji (na jego stronie).
SIGN_UP Ten post wymaga, aby użytkownik się zarejestrował lub dołączył do czegoś.
GET_OFFER

Rola wycofana. Użyj kodu OFFER w usłudze LocalPostTopicType, aby utworzyć posta z treścią oferty.
CALL Ten post wymaga, aby użytkownik zadzwonił do firmy.

LocalPostEvent

Wszystkie informacje dotyczące wydarzenia wskazanego w lokalnym poście.

Zapis JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Pola
title

string

Nazwa zdarzenia.
schedule

object (TimeInterval)

Data i godzina rozpoczęcia i zakończenia wydarzenia.

TimeInterval

Przedział czasu włącznie. Aby był prawidłowy, musi zawierać wszystkie pola.

Zapis JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Pola
startDate

object (Date)

Data rozpoczęcia tego okresu.
startTime

object (TimeOfDay)

Godzina rozpoczęcia tego okresu.
endDate

object (Date)

Data zakończenia tego okresu.
endTime

object (TimeOfDay)

Godzina zakończenia tego okresu.

TimeOfDay

Przedstawia porę dnia. Data i strefa czasowa są nieistotne lub zostały określone w innym miejscu. Interfejs API może zezwolić na sekundy przestępne. Podobne typy to google.type.Date i google.protobuf.Timestamp.

Zapis JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Pola
hours

integer

Godziny dnia w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23. Interfejs API może zezwolić na wartość „24:00:00” w takich sytuacjach jak zamknięcie firmy.
minutes

integer

Minuty dnia. Wartość musi mieścić się w przedziale od 0 do 59.
seconds

integer

Sekundy czasu trwania. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może akceptować wartość 60, jeśli zezwala na użycie sekund przestępnych.
nanos

integer

Ułamki sekund w nanosekundach. Musi mieścić się w przedziale od 0 do 999 999 999.

LocalPostState

Wskazuje, w jakim stanie jest post

Wartości w polu enum
LOCAL_POST_STATE_UNSPECIFIED Nie określono stanu.
REJECTED Ten post został odrzucony z powodu naruszenia polityki treści.
LIVE Ten post został opublikowany i obecnie wyświetla się w wynikach wyszukiwania.
PROCESSING Ten post jest przetwarzany i nie wyświetla się w wynikach wyszukiwania.

LocalPostTopicType

Typ tematu posta lokalnego, który służy do wybierania różnych szablonów do tworzenia i renderowania posta.

Wartości w polu enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Nie określono typu posta.
STANDARD Post zawiera podstawowe informacje, takie jak podsumowanie i obrazy.
EVENT Post zawiera podstawowe informacje i wydarzenie.
OFFER Post zawiera podstawowe informacje, wydarzenie i treści związane z ofertą (np. kod kuponu)
ALERT Trafne i aktualne ogłoszenia związane z trwającym wydarzeniem. Nie zawsze można tworzyć posty tego typu.

AlertType

Typ zdarzenia, dla którego został utworzony post z alertem.

Wartości w polu enum
ALERT_TYPE_UNSPECIFIED Nie określono alertu.
COVID_19 Alerty związane z pandemią koronawirusa w 2019 roku. Posty dotyczące COVID-19 obsługują tylko pola podsumowania i wezwania do działania. Gdy te alerty nie są już aktualne, tworzenie nowych wpisów z alertami typu COVID-19 zostanie wyłączone. Sprzedawca nadal będzie mógł jednak zarządzać swoimi istniejącymi wpisami dotyczącymi COVID-19.

LocalPostOffer

Konkretne pola do wpisów ofert.

Zapis JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Pola
couponCode

string

Opcjonalnie: Kod oferty do wykorzystania w sklepie stacjonarnym lub online.
redeemOnlineUrl

string

Opcjonalnie: Link online umożliwiający skorzystanie z oferty.
termsConditions

string

Opcjonalnie: Warunki oferty

Metody

create

 Tworzy nowego lokalnego posta powiązanego z określoną lokalizacją i zwraca go.

delete

 Usuwa lokalnego posta.

get

 Pobiera określonego posta lokalnego.

list

 Zwraca listę postów lokalnych powiązanych z lokalizacją.

patch

 Aktualizuje określonego posta lokalnego i zwraca zaktualizowanego posta.

reportInsights

 Zwraca statystyki dla zbioru postów lokalnych powiązanych z jedną wizytówką.