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,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
Felder
name

string

Nur Ausgabe. Google-ID für diesen lokalen Beitrag im Format: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
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.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informationen zum Ereignis 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 Medien. „sourceUrl“ ist das einzige unterstützte Datenfeld für ein MediaItem von LocalPost.
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, Veranstaltung, Angebot oder Benachrichtigung.
alertType

enum (AlertType)

Der Benachrichtigungstyp, für den der Beitrag erstellt wird. Dieses Feld gilt nur für Beiträge vom Typ „Benachrichtigung“ und ist ein Untertyp von „Benachrichtigungen“.
offer

object (LocalPostOffer)

Zusätzliche Daten für Angebotsbeiträge. Dieser Wert sollte nur festgelegt werden, wenn der „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 sich der Nutzer registriert, 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)
  }
}
Felder
title

string

Name des Ereignisses.
schedule

object (TimeInterval)

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

TimeInterval

Ein Zeitintervall (einschließlich). Er muss alle Felder enthalten, um gültig zu sein.

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.

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 im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen.
seconds

integer

Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen.

LocalPostState

Gibt an, in welchem Status sich der Beitrag befindet.

Enums
LOCAL_POST_STATE_UNSPECIFIED Status nicht angegeben.
REJECTED Dieser Beitrag wurde aufgrund eines Verstoßes gegen die Inhaltsrichtlinien abgelehnt.
LIVE Dieser Beitrag ist veröffentlicht und wird derzeit in den Suchergebnissen angezeigt.
PROCESSING Dieser Beitrag wird verarbeitet und erscheint nicht in den Suchergebnissen.

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. 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 zum Thema COVID-19 sind nur ein Zusammenfassungsfeld und ein Call-to-Action-Feld zulässig. Sobald diese Warnungen nicht mehr relevant sind, wird das Erstellen neuer Beiträge vom Typ „COVID-19“ deaktiviert. Händler können jedoch weiterhin ihre vorhandenen Beiträge zur Coronakrise verwalten.

LocalPostOffer

Bestimmte 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. Angebotsbedingungen.

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 lokaler Beiträge zurück, die mit einem Standort verknüpft sind.

patch

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

reportInsights

 Gibt Statistiken für eine Reihe von lokalen Beiträgen zurück, die mit einem einzelnen Eintrag verknüpft sind.