REST Resource: accounts.locations.localPosts

Zasób: LocalPost

Reprezentuje lokalny post w lokalizacji.

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

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
Pola
name

string

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

string

Język lokalnego posta.
summary

string

Opis/treść posta lokalnego.
callToAction

object (CallToAction)

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

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia posta.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Jeśli jest ustawiona, określa, kiedy post zostanie opublikowany. Użytkownik może ustawić tę opcję, aby zaplanować posty z wyprzedzeniem.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady event.recurring_instance_time. To pole zostanie usunięte w przyszłej wersji. Tylko dane wyjściowe. Czas ostatniej aktualizacji najnowszej powtarzającej się instancji posta.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
event

object (LocalPostEvent)

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

enum (LocalPostState)

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

object (MediaItem)

Media powiązane z postem. sourceUrl to jedyne obsługiwane pole danych w przypadku elementu LocalPost MediaItem.
searchUrl

string

Tylko dane wyjściowe. Link do posta lokalnego w wyszukiwarce Google. Ten link umożliwia udostępnianie posta w mediach społecznościowych, e-mailach, 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 posta. To pole ma zastosowanie tylko w przypadku postów o wartości topicType Alert i działa jako podtyp alertów.
Pole zbiorcze topic_type_specific_fields. konkretne pola dla typu tematu; topic_type_specific_fields może mieć tylko jedną z tych wartości:
offer

object (LocalPostOffer)

Dodatkowe dane dotyczące postów z ofertami. 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, do którego użytkownik zostanie przekierowany po kliknięciu. W przypadku wezwania do działania „Zadzwoń” to pole powinno pozostać nieustawione.

ActionType

Typ działania, które zostanie wykonane.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED Typ nieokreślony.
BOOK Ten post ma zachęcić użytkownika do zarezerwowania terminu, stolika itp.
ORDER Ten post ma zachęcić użytkownika do zamówienia czegoś.
SHOP Ten post ma zachęcić użytkownika do przeglądania katalogu produktów.
LEARN_MORE Ten post ma zachęcić użytkownika do uzyskania więcej informacji (w witrynie).
SIGN_UP Ten post zachęca użytkownika do zarejestrowania się, utworzenia konta lub dołączenia do czegoś.
GET_OFFER

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

LocalPostEvent

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

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

string

nazwa zdarzenia,
schedule

object (TimeInterval)

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

object (RecurrenceInfo)

Opcjonalnie. Przechowuje informacje o częstotliwości publikowania cyklicznego posta. Ustawiany tylko wtedy, gdy post jest postem cyklicznym.
recurringInstanceTime

string (Timestamp format)

Tylko dane wyjściowe. Czas ostatniej aktualizacji najnowszej powtarzającej się instancji posta.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

TimeInterval

Przedział czasu (włącznie z wartościami granicznymi). Aby był ważny, 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.

Data

Reprezentuje pełną lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z rokiem zerowym (np. rocznica).
  • Sam rok, z miesiącem i dniem o wartości zero.
  • Rok i miesiąc z dniem zerowym (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku.
month

integer

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok albo rok i miesiąc, w których dzień nie ma znaczenia.

TimeOfDay

Reprezentuje porę dnia. Data i strefa czasowa nie mają znaczenia lub są określone w innym miejscu. Interfejs API może zezwalać na sekundy przestępne. 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ść musi być równa lub większa niż 0 i zwykle nie może być większa niż 23. Interfejs API może zezwalać na wartość „24:00:00” w przypadku takich scenariuszy jak godzina zamknięcia firmy.
minutes

integer

Minuty w godzinie. Wartość musi być równa lub większa niż 0 i równa lub mniejsza niż 59.
seconds

integer

Sekundy w minucie. Wartość musi być równa lub większa niż 0 i zwykle nie może być większa niż 59. Interfejs API może zezwalać na wartość 60, jeśli dopuszcza sekundy przestępne.
nanos

integer

Ułamki sekund w nanosekundach. Wartość musi być równa lub większa niż 0 i mniejsza lub równa 999 999 999.

RecurrenceInfo

Reprezentuje informacje o powtarzaniu posta lokalnego.

Zapis JSON 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
Pola
seriesEndTime

string (Timestamp format)

Opcjonalnie. Czas zakończenia serii powtórzeń.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
Pole zbiorcze occurrence_pattern. Wzorzec występowania posta cyklicznego. occurrence_pattern może mieć tylko jedną z tych wartości:
dailyPattern

object (DailyOccurrencePattern)

Wzorzec codziennego występowania.
weeklyPattern

object (WeeklyOccurrencePattern)

Wzorzec występowania tygodniowego.
monthlyPattern

object (MonthlyOccurrencePattern)

Wzorzec miesięczny.

DailyOccurrencePattern

Ten typ nie ma pól.

Reprezentuje wzorzec występowania codziennego.

WeeklyOccurrencePattern

Reprezentuje wzorzec występowania tygodniowego.

Zapis JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Pola
daysOfWeek[]

enum (DayOfWeek)

Opcjonalnie. Lista dni tygodnia, w których obowiązuje oferta lub wydarzenie. Jeśli to pole jest puste, post będzie się powtarzać w tym samym dniu tygodnia co schedule.start_time wydarzenia.

DzieńTygodnia

Reprezentuje dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia jest nieokreślony.
MONDAY Poniedziałek
TUESDAY Tuesday (wtorek)
WEDNESDAY Wednesday (środa)
THURSDAY Thursday (czwartek)
FRIDAY Friday (piątek)
SATURDAY Saturday (sobota)
SUNDAY Niedziela

MonthlyOccurrencePattern

Reprezentuje miesięczny wzorzec występowania.

Zapis JSON 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
Pola
Pole zbiorcze monthly_option. Opcja powtarzania w przypadku miesięcznego wzorca powtarzania. monthly_option może mieć tylko jedną z tych wartości:
dayOfMonth

integer

Dzień miesiąca.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

Dzień tygodnia w miesiącu. Dzień tygodnia jest określony przez dzień tygodnia, w którym rozpoczyna się wydarzenie. Jeśli np. wydarzenie rozpoczyna się w piątek, a dayOfWeekOccurrence ma wartość SECOND, wydarzenie będzie się powtarzać w drugi piątek każdego miesiąca.

DayOfWeekOccurrence

Dzień tygodnia w miesiącu.

Wartości w polu enum
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED Nieokreślony dzień tygodnia.
FIRST Pierwszy dzień tygodnia w miesiącu.
SECOND Drugi dzień tygodnia w miesiącu.
THIRD Trzeci dzień tygodnia w miesiącu.
FOURTH Czwarty dzień tygodnia w miesiącu.
LAST Ostatni dzień tygodnia w miesiącu.

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 jest opublikowany i wyświetla się w wynikach wyszukiwania.
PROCESSING Ten post jest przetwarzany i nie pojawia się w wynikach wyszukiwania.
SCHEDULED Ten post jest zaplanowany na przyszłość i nie pojawia się w wynikach wyszukiwania.
RECURRING Ten post jest postem cyklicznym i obecnie 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, treść związaną z wydarzeniem i ofertą (np. kod kuponu)
ALERT Ważne i aktualne ogłoszenia związane z trwającym wydarzeniem. Tego typu posty nie zawsze są dostępne do tworzenia.

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 2019. Posty dotyczące COVID-19 obsługują tylko pole podsumowania i pole wezwania do działania. Gdy te alerty przestaną być istotne, tworzenie nowych postów z alertami typu COVID-19 zostanie wyłączone. Sprzedawca będzie jednak nadal mógł zarządzać dotychczasowymi postami dotyczącymi COVID-19.

LocalPostOffer

Konkretne pola dla postów z ofertami.

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

string

Opcjonalnie. Kod oferty, którego można użyć 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 go zwraca.

delete

 Usuwa post lokalny.

get

 Pobiera określoną placówkę pocztową.

list

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

patch

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