REST Resource: accounts.locations.localPosts

Zasób: LocalPost

Reprezentuje post lokalny dotyczący danej 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 wpisu w usłudze Google w formie: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Język lokalnego postu.
summary

string

Opis/tekst posta lokalnego.
callToAction

object (CallToAction)

Adres URL, na który użytkownicy są przekierowywani po kliknięciu oferty promocyjnej. Ignorowane w przypadku tematu typu OFFER.
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia posta.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc 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 formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informacje o wydarzeniu. Wymagane w przypadku tematów typu EVENT i OFFER.
state

enum (LocalPostState)

Tylko dane wyjściowe. Stan wpisu, który wskazuje, na którym etapie cyklu życia się znajduje.
media[]

object (MediaItem)

Multimedia powiązane z postem. sourceUrl jest jedynym obsługiwanym polem danych w przypadku obiektu MediaItem w ramach wiadomości lokalnej.
searchUrl

string

Tylko dane wyjściowe. Link do lokalnego postu w wyszukiwarce Google. Link ten można wykorzystać do udostępnienia posta w mediach społecznościowych, e-mailu, wiadomościach tekstowych itp.
topicType

enum (LocalPostTopicType)

Wymagane. Typ tematu wpisu: standardowy, wydarzenie, oferta lub alert.
alertType

enum (AlertType)

Typ alertu, dla którego utworzono post. To pole ma zastosowanie tylko do postów typu topicType Alert i działa jak podtyp alertów.
offer

object (LocalPostOffer)

dodatkowe dane w postach z ofertą, To ustawienie powinno być ustawione tylko wtedy, gdy typ tematu to 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, pod który zostanie przekierowany użytkownik po kliknięciu. W przypadku wezwania do działania przez telefon to pole powinno pozostać puste.

ActionType

Typ działania, które zostanie wykonane.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED Nieokreślony typ.
BOOK Ten post zachęca użytkownika do rezerwacji spotkania, stolika itp.
ORDER Ten post zachęca użytkownika do zamówienia czegoś.
SHOP Ten post zachęca użytkownika do przeglądania katalogu produktów.
LEARN_MORE Ten post zachęca użytkownika do dowiedzenia się więcej (w witrynie firmy).
SIGN_UP Ten post zachęca użytkownika do rejestracji lub dołączenia do czegoś.
GET_OFFER

Rola wycofana. Użyj elementu OFFER w elementzie LocalPostTopicType, aby utworzyć post z treścią oferty.
CALL Ten post zachęca użytkowników do zadzwonienia do firmy.

LocalPostEvent

Wszystkie informacje dotyczące wydarzenia w postu lokalnym.

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

string

Nazwa zdarzenia.
schedule

object (TimeInterval)

Data i godzina rozpoczęcia oraz 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)

Czas rozpoczęcia tego okresu.
endDate

object (Date)

Data zakończenia tego okresu.
endTime

object (TimeOfDay)

Czas zakończenia tego okresu.

TimeOfDay

Oznacza porę dnia. Strefa czasowa i data są nieistotne lub są określone gdzie indziej. Interfejs API może zezwalać na sekundy przesunięte. Powiązane typy to google.type.Date i google.protobuf.Timestamp.

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

integer

Godziny 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 przypadku scenariuszy takich jak godziny zamknięcia firmy.
minutes

integer

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

integer

sekundy, Wartość musi mieścić się w zakresie od 0 do 59. Interfejs API może zezwalać na wartość 60, jeśli zezwala na sekundy przestępne.
nanos

integer

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

LocalPostState

Wskazuje stan posta.

Wartości w polu enum
LOCAL_POST_STATE_UNSPECIFIED Stan nieokreślony.
REJECTED Ten post został odrzucony z powodu naruszenia zasad dotyczących treści.
LIVE Ten post został opublikowany i obecnie wyświetla się w wynikach wyszukiwania.
PROCESSING Ten post jest przetwarzany i nie pojawia się w wynikach wyszukiwania.

LocalPostTopicType

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

Wartości w polu enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Nie wybrano typu posta.
STANDARD Post zawiera podstawowe informacje, takie jak podsumowanie i obrazy.
EVENT Post zawiera podstawowe informacje i zdarzenie.
OFFER Post zawiera podstawowe informacje, wydarzenie i treści związane z ofertą (np. kod kuponu)
ALERT Ogłoszenia o wysokim priorytecie i związane z aktualnym wydarzeniem. Te typy postów nie zawsze są dostępne do publikowania.

AlertType

Typ zdarzenia, dla którego utworzono wpis z alertem.

Wartości w polu enum
ALERT_TYPE_UNSPECIFIED Nie określono alertu.
COVID_19 alerty związane z pandemią choroby koronawirusowej z 2019 r.; Posty dotyczące COVID-19 obsługują tylko pole podsumowania i pole wezwania do działania. Gdy te alerty nie będą już aktualne, utworzenie nowego wpisu z alertem o rodzaju COVID-19 zostanie wyłączone. Sprzedawca będzie jednak nadal mógł zarządzać istniejącymi postami dotyczącymi COVID-19.

LocalPostOffer

Specjalne pola w postach z ofertą

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

string

Opcjonalnie: Kod oferty, który można wykorzystać w sklepie lub online.
redeemOnlineUrl

string

Opcjonalnie: Link online do skorzystania z oferty.
termsConditions

string

Opcjonalnie: Warunki oferty.

Metody

create

 Tworzy nowy post lokalny powiązany z określoną lokalizacją i zwraca go.

delete

 Usuwa post lokalny.

get

 Pobiera określony lokalny urząd pocztowy.

list

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

patch

 Aktualizuje określony post lokalny i zwraca zaktualizowany post lokalny.

reportInsights

 Zwraca statystyki dotyczące zestawu postów lokalnych powiązanych z pojedynczą wizytówką.