REST Resource: accounts.locations.localPosts

Ressource: LocalPost

Stellt einen lokalen Beitrag für einen Standort dar.

JSON-Darstellung 
{
  "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.
}
Felder
name

string

Nur Ausgabe. Google-ID für diesen lokalen Beitrag im Format: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
languageCode

string

Die Sprache des lokalen Beitrags.
summary

string

Beschreibung/Text des lokalen Beitrags.
callToAction

object (CallToAction)

Die URL, an die Nutzer weitergeleitet werden, wenn sie auf die Werbeaktion klicken Wird für den Thementyp „OFFER“ ignoriert.
createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der Erstellung des Beitrags.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der letzten Änderung des Beitrags durch den Nutzer.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Wenn festgelegt, wird damit bestimmt, wann ein Beitrag veröffentlicht wird. Nutzer können diese Einstellung verwenden, um Beiträge im Voraus zu planen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen event.recurring_instance_time. Dieses Feld wird in einer zukünftigen Version entfernt. Nur Ausgabe. Der Zeitpunkt, zu dem die letzte wiederkehrende Instanz des Beitrags aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
event

object (LocalPostEvent)

Ereignisinformationen. Erforderlich für die Thementypen EVENT und OFFER.
state

enum (LocalPostState)

Nur Ausgabe. Der Status des Beitrags, der angibt, in welcher Phase des Lebenszyklus er sich befindet.
media[]

object (MediaItem)

Die mit dem Beitrag verknüpften Media. sourceUrl ist das einzige unterstützte Datenfeld für ein LocalPost-MediaItem.
searchUrl

string

Nur Ausgabe. Link zum lokalen Beitrag in der Google Suche. Dieser Link kann verwendet werden, um den Beitrag über soziale Medien, E-Mails, SMS usw. zu teilen.
topicType

enum (LocalPostTopicType)

Erforderlich. Der Thementyp des Beitrags: „standard“, „event“, „offer“ oder „alert“.
alertType

enum (AlertType)

Der Benachrichtigungstyp, für den der Beitrag erstellt wird. Dieses Feld gilt nur für Beiträge des Typs „Benachrichtigung“ und verhält sich wie ein Untertyp von Benachrichtigungen.
Union-Feld topic_type_specific_fields. Spezifische Felder für einen Thementyp. Für topic_type_specific_fields ist nur einer der folgenden Werte zulässig:
offer

object (LocalPostOffer)

Zusätzliche Daten für Angebotsbeiträge. Sollte nur festgelegt werden, wenn „topicType“ „OFFER“ ist.

CallToAction

Eine Aktion, die ausgeführt wird, wenn der Nutzer auf den Beitrag klickt

JSON-Darstellung 
{
  "actionType": enum (ActionType),
  "url": string
}
Felder
actionType

enum (ActionType)

Die Art der auszuführenden Aktion.
url

string

Die URL, zu der der Nutzer weitergeleitet wird, wenn er auf eine Anzeige klickt. Dieses Feld sollte für den Call-to-Action nicht festgelegt werden.

ActionType

Die Art der auszuführenden Aktion.

Enums
ACTION_TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
BOOK Mit diesem Beitrag soll erreicht werden, dass der Nutzer einen Termin vereinbart/Tisch reserviert usw.
ORDER Mit diesem Beitrag soll erreicht werden, dass der Nutzer etwas bestellt.
SHOP Mit diesem Beitrag soll erreicht werden, dass der Nutzer einen Produktkatalog durchblättert.
LEARN_MORE Mit diesem Beitrag soll erreicht werden, dass der Nutzer (auf der Website) weitere Informationen erhält.
SIGN_UP Mit diesem Beitrag soll erreicht werden, dass der Nutzer sich registriert, sich anmeldet oder zu etwas betritt.
GET_OFFER

Verworfen. Verwenden Sie OFFER in LocalPostTopicType, um einen Beitrag mit Angebotsinhalten zu erstellen.
CALL Mit diesem Beitrag soll erreicht werden, dass der Nutzer das Unternehmen anruft.

LocalPostEvent

Alle Informationen zu einer Veranstaltung, auf die in einem lokalen Beitrag hingewiesen wird

JSON-Darstellung 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
Felder
title

string

Name des Ereignisses.
schedule

object (TimeInterval)

Start- und Enddatum sowie Start- und Endzeit der Veranstaltung.
recurrenceInfo

object (RecurrenceInfo)

Optional. Speichert Informationen zur Häufigkeit eines wiederkehrenden Beitrags. Wird nur festgelegt, wenn der Beitrag ein wiederkehrender Beitrag ist.
recurringInstanceTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die letzte wiederkehrende Instanz des Beitrags aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

TimeInterval

Ein Zeitintervall (einschließlich). Es muss alle Felder enthalten, damit es gültig ist.

JSON-Darstellung 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Felder
startDate

object (Date)

Das Startdatum dieses Zeitraums
startTime

object (TimeOfDay)

Die Startzeit dieses Zeitraums.
endDate

object (Date)

Das Enddatum dieses Zeitraums
endTime

object (TimeOfDay)

Die Endzeit dieses Zeitraums

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
  • Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
  • Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der Kreditkarte)

Ähnliche Typen:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird.
month

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist.

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

integer

Sekunden einer Minute. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

RecurrenceInfo

Stellt die Wiederholungsinformationen für einen lokalen Beitrag dar.

JSON-Darstellung 
{
  "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.
}
Felder
seriesEndTime

string (Timestamp format)

Optional. Die Endzeit der Wiederholungsserie.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
Union-Feld occurrence_pattern. Das Wiederholungsmuster für den wiederkehrenden Beitrag. Für occurrence_pattern ist nur einer der folgenden Werte zulässig:
dailyPattern

object (DailyOccurrencePattern)

Tägliches Muster.
weeklyPattern

object (WeeklyOccurrencePattern)

Wöchentliches Muster.
monthlyPattern

object (MonthlyOccurrencePattern)

Monatliches Muster.

DailyOccurrencePattern

Dieser Typ hat keine Felder.

Stellt ein tägliches Wiederholungsmuster dar.

WeeklyOccurrencePattern

Stellt ein wöchentliches Wiederholungsmuster dar.

JSON-Darstellung 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Felder
daysOfWeek[]

enum (DayOfWeek)

Optional. Die Liste der Wochentage für das Angebot/Ereignis. Wenn leer, wird der Beitrag am selben Wochentag wie die schedule.start_time des Ereignisses wiederholt.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

MonthlyOccurrencePattern

Stellt ein monatliches Wiederholungsmuster dar.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld monthly_option. Die Wiederholungsoption für das monatliche Wiederholungsmuster. Für monthly_option ist nur einer der folgenden Werte zulässig:
dayOfMonth

integer

Der Tag des Monats.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

Der Tag der Woche im Monat. Der Wochentag ergibt sich aus dem Wochentag der Startzeit des Ereignisses. Wenn ein Ereignis beispielsweise an einem Freitag beginnt und „dayOfWeekOccurrence“ auf „SECOND“ festgelegt ist, wird das Ereignis am zweiten Freitag jedes Monats wiederholt.

DayOfWeekOccurrence

Der Tag der Woche im Monat.

Enums
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED Nicht angegebener Wochentag.
FIRST Erster Tag der Woche im Monat.
SECOND Zweiter Tag der Woche im Monat.
THIRD Dritter Tag der Woche im Monat.
FOURTH Vierter Tag der Woche im Monat.
LAST Letzter Tag der Woche im Monat.

LocalPostState

Gibt den Status des Beitrags an.

Enums
LOCAL_POST_STATE_UNSPECIFIED Status ist nicht angegeben.
REJECTED Dieser Beitrag wurde aufgrund eines Verstoßes gegen die Inhaltsrichtlinien abgelehnt.
LIVE Dieser Beitrag wurde veröffentlicht und wird derzeit in den Suchergebnissen angezeigt.
PROCESSING Dieser Beitrag wird verarbeitet und erscheint nicht in den Suchergebnissen.
SCHEDULED Dieser Beitrag ist für die Zukunft geplant und erscheint nicht in den Suchergebnissen.
RECURRING Dieser Beitrag ist ein wiederkehrender Beitrag und wird derzeit in den Suchergebnissen angezeigt.

LocalPostTopicType

Das ist der Thementyp des lokalen Beitrags, mit dem verschiedene Vorlagen zum Erstellen und Rendern eines Beitrags ausgewählt werden.

Enums
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Es wurde kein Beitragstyp angegeben.
STANDARD Der Beitrag enthält allgemeine Informationen wie eine Zusammenfassung und Bilder.
EVENT Der Beitrag enthält grundlegende Informationen und eine Veranstaltung.
OFFER Der Beitrag enthält grundlegende Informationen, eine Veranstaltung und Inhalte in Bezug auf das Angebot (z. B. einen Gutscheincode).
ALERT Wichtige und aktuelle Ankündigungen in Bezug auf eine laufende Veranstaltung. Diese Beiträge sind nicht immer zum Erstellen verfügbar.

AlertType

Der Typ des Ereignisses, für das der Benachrichtigungsbeitrag erstellt wurde.

Enums
ALERT_TYPE_UNSPECIFIED Es wurde keine Benachrichtigung angegeben.
COVID_19 Benachrichtigungen im Zusammenhang mit der Coronavirus-Pandemie (COVID-19). Bei Beiträgen zu COVID-19 werden nur ein Zusammenfassungsfeld und ein Call-to-Action-Feld unterstützt. Wenn diese Benachrichtigungen nicht mehr relevant sind, wird die Erstellung neuer Warnbeiträge vom Typ „COVID-19“ deaktiviert. Händler können ihre bestehenden Beiträge zur Coronakrise jedoch weiterhin verwalten.

LocalPostOffer

Spezielle Felder für Angebotsbeiträge

JSON-Darstellung 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Felder
couponCode

string

Optional. Angebotscode, der im Geschäft oder online eingelöst werden kann.
redeemOnlineUrl

string

Optional. Onlinelink zum Einlösen des Angebots.
termsConditions

string

Optional. Nutzungsbedingungen für das Angebot.

Methoden

create

 Erstellt einen neuen lokalen Beitrag, der dem angegebenen Standort zugeordnet ist, und gibt ihn zurück.

delete

 Löscht einen lokalen Beitrag.

get

 Ruft den angegebenen lokalen Beitrag ab.

list

 Gibt eine Liste von lokalen Beiträgen zurück, die mit einem Standort verknüpft sind.

patch

 Aktualisiert den angegebenen lokalen Beitrag und gibt den aktualisierten lokalen Beitrag zurück.