REST Resource: accounts.locations.localPosts

Zasób: LocalPost

Reprezentuje lokalny wpis 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 lokalnego posta w formacie: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Język lokalnego posta.
summary

string

Opis lub treść lokalnego posta.
callToAction

object (CallToAction)

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

string (Timestamp format)

Tylko dane wyjściowe. Godzina utworzenia posta.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 wydarzeniu. Wymagane dla tematów typu EVENT i OFFER.
state

enum (LocalPostState)

Tylko dane wyjściowe. Stan posta wskazujący, na jakim etapie cyklu życia go znajduje.
media[]

object (MediaItem)

Media 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. Tego linku można użyć do udostępnienia posta w mediach społecznościowych, przez e-maila, SMS-a itp.
topicType

enum (LocalPostTopicType)

To pole jest wymagane. Typ tematu posta: standardowy, wydarzenie, oferta lub alert.
alertType

enum (AlertType)

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

object (LocalPostOffer)

Dodatkowe dane dla postów z ofertami. Ten parametr należy ustawić tylko wtedy, gdy typ topicType ma wartość OFFER.

CallToAction

Działanie, które wykonuje się, gdy użytkownik kliknie wpis.

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 użytkownik zostanie przekierowany po kliknięciu. To pole nie powinno być skonfigurowane w przypadku wezwania do działania.

ActionType

Typ działania, które zostanie wykonane.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED Typ nieokreślony.
BOOK Ten post wymaga, aby użytkownik umawiał się na spotkania, stoliki itp.
ORDER Ten post chce, aby użytkownik coś zamówił.
SHOP Ten post ma zachęcić użytkownika do przeglądania katalogu produktów.
LEARN_MORE Użytkownik chce dowiedzieć się więcej na temat tego posta (na swojej stronie internetowej).
SIGN_UP Ten post wymaga, aby użytkownik się zarejestrował, zarejestrował lub dołączył.
GET_OFFER

Rola wycofana. Użyj OFFER w aplikacji LocalPostTopicType, aby utworzyć posta z treścią oferty.
CALL Ten post ma zachęcić użytkownika, żeby zadzwonił do firmy.

LocalPostEvent

Wszystkie informacje związane z wydarzeniem opublikowane w lokalnych poście.

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

string

Nazwa zdarzenia.
schedule

object (TimeInterval)

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

TimeInterval

Przedział czasu włącznie. Aby plik 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

Reprezentuje 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. Pokrewne rodzaje treści: 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. W przypadku takich sytuacji jak godzina zamknięcia firmy interfejs API może zezwolić na wartość „24:00:00”.
minutes

integer

Minuty w ciągu dnia. Wymagana wartość z zakresu od 0 do 59.
seconds

integer

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

integer

Ułamki sekund w nanosekundach. Wartość 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 Nie określono stanu.
REJECTED Ten post został odrzucony z powodu naruszenia polityki treści.
LIVE Ten post został opublikowany i jest obecnie wyświetlany w wynikach wyszukiwania.
PROCESSING Ten post jest teraz przetwarzany i nie wyświetla się w wynikach wyszukiwania.

LocalPostTopicType

Typ tematu lokalnego posta, 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 powiązane z ofertą (np. kod kuponu)
ALERT Powiadomienia o wysokim priorytecie i aktualne informacje dotyczące trwającego wydarzenia. Tego typu posty nie zawsze są dostępne do tworzenia.

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. W postach dotyczących COVID-19 dostępne są tylko pola podsumowania i pole wezwania do działania. Gdy te alerty przestaną być przydatne, wyłączymy możliwość tworzenia nowych postów z alertami dotyczącymi typu COVID-19. Sprzedawca nadal będzie mógł jednak zarządzać swoimi dotychczasowymi wpisami dotyczącymi COVID-19.

LocalPostOffer

Pola szczegółowe we wpisach z ofertami.

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

string

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

string

Opcjonalnie. Link online do skorzystania z oferty.
termsConditions

string

Opcjonalnie. Warunki oferty.

Metody

create

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

delete

 Usuwa lokalny post.

get

 Pobiera określony lokalny post.

list

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

patch

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

reportInsights

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