- Zasób: LocalPost
- CallToAction
- ActionType
- LocalPostEvent
- TimeInterval
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- AlertType
- LocalPostOffer
- Metody
Zasób: LocalPost
Reprezentuje lokalny wpis dotyczący lokalizacji.
Zapis JSON | |
---|---|
{ "name": string, "languageCode": string, "summary": string, "callToAction": { object ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Identyfikator Google dla tego lokalnego posta w formacie: |
languageCode |
Język lokalnego posta. |
summary |
Opis lub treść lokalnego posta. |
callToAction |
Adres URL, na który trafiają użytkownicy po kliknięciu promocji. Ignorowany w przypadku typu tematu |
createTime |
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: |
updateTime |
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: |
event |
Informacje o wydarzeniu. Wymagane dla tematów typu |
state |
Tylko dane wyjściowe. Stan posta wskazujący, na jakim etapie cyklu życia go znajduje. |
media[] |
Media powiązane z postem. sourceUrl to jedyne obsługiwane pole danych dla elementu LocalPost MediaItem. |
searchUrl |
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 |
To pole jest wymagane. Typ tematu posta: standardowy, wydarzenie, oferta lub alert. |
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 |
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 ( |
Pola | |
---|---|
actionType |
Typ działania, które zostanie wykonane. |
url |
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 |
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 ( |
Pola | |
---|---|
title |
Nazwa zdarzenia. |
schedule |
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 ( |
Pola | |
---|---|
startDate |
Data rozpoczęcia tego okresu. |
startTime |
Godzina rozpoczęcia tego okresu. |
endDate |
Data zakończenia tego okresu. |
endTime |
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 |
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 |
Minuty w ciągu dnia. Wymagana wartość z zakresu od 0 do 59. |
seconds |
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 |
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 |
Opcjonalnie. Kod oferty do wykorzystania w sklepie lub online. |
redeemOnlineUrl |
Opcjonalnie. Link online do skorzystania z oferty. |
termsConditions |
Opcjonalnie. Warunki oferty. |
Metody |
|
---|---|
|
Tworzy nowego posta lokalnego powiązanego z określoną lokalizacją i zwraca go. |
|
Usuwa lokalny post. |
|
Pobiera określony lokalny post. |
|
Zwraca listę lokalnych postów powiązanych z lokalizacją. |
|
Aktualizuje określony lokalny post i zwraca zaktualizowany post lokalny. |
|
Zwraca statystyki dotyczące zbioru lokalnych postów powiązanych z jedną wizytówką. |