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-Kennung 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 Werbung klicken. Wird für Thementyp OFFER ignoriert.
createTime

string (Timestamp format)

Nur Ausgabe Zeitpunkt der Erstellung des Beitrags.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

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

enum (LocalPostState)

Nur Ausgabe Der Status des Beitrags, der angibt, in welchem Teil seines Lebenszyklus er sich befindet.
media[]

object (MediaItem)

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

string

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

enum (LocalPostTopicType)

Erforderlich. Der Thementyp des Beitrags: „Standard“, „Ereignis“, „Angebot“ oder „Benachrichtigung“.
alertType

enum (AlertType)

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

object (LocalPostOffer)

Zusätzliche Daten für Beiträge zu Angeboten. Sollte nur festgelegt werden, wenn als topicType OFFER angegeben 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

URL, zu der der Nutzer weitergeleitet wird, wenn er auf die 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 Nutzer einen Termin vereinbaren, einen Tisch reservieren usw.
ORDER Mit diesem Beitrag soll erreicht werden, dass der Nutzer etwas bestellt.
SHOP Mit diesem Beitrag soll erreicht werden, dass der Nutzer sich einen Produktkatalog durchstöbert.
LEARN_MORE Mit diesem Beitrag soll erreicht werden, dass der Nutzer weitere Informationen auf seiner Website erhält.
SIGN_UP Mit diesem Beitrag soll erreicht werden, dass Nutzer sich registrieren/anmelden/bei etwas mitmachen.
GET_OFFER

Veraltet. Verwende OFFER in LocalPostTopicType, um einen Beitrag mit Angebotsinhalten zu erstellen.
CALL Mit diesem Beitrag soll erreicht werden, dass Nutzer das Unternehmen anrufen.

LocalPostEvent

Alle Informationen zu einer Veranstaltung, die in einem lokalen Beitrag erwähnt wird.

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

string

Name des Ereignisses.
schedule

object (TimeInterval)

Start- und Enddatum des Ereignisses.

TimeInterval

Ein Zeitintervall (einschließlich). Es müssen alle Felder enthalten sein, 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)

Das Ende 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 wurde veröffentlicht und erscheint derzeit in den Suchergebnissen.
PROCESSING Dieser Beitrag wird verarbeitet und erscheint nicht in den Suchergebnissen.

LocalPostTopicType

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 grundlegende Informationen, z. B. eine Zusammenfassung und Bilder.
EVENT Der Beitrag enthält grundlegende Informationen und eine Veranstaltung.
OFFER Der Beitrag enthält grundlegende Informationen, eine Veranstaltung und angebotsbezogene Inhalte (z. B. einen Gutscheincode).
ALERT Wichtige und zeitnahe Ankündigungen zu einer laufenden Veranstaltung Diese Arten von Beiträgen können nicht immer erstellt werden.

AlertType

Der Ereignistyp, für den der Benachrichtigungsbeitrag erstellt wurde.

Enums
ALERT_TYPE_UNSPECIFIED Es wurde keine Benachrichtigung angegeben.
COVID_19 Warnungen zur Coronapandemie 2019. Bei Beiträgen zu COVID-19 können nur Zusammenfassungen und Call-to-Action-Felder angegeben werden. Wenn diese Benachrichtigungen nicht mehr relevant sind, werden neue Benachrichtigungsbeiträge für den Typ „COVID-19“ deaktiviert. Händler können jedoch weiterhin ihre bestehenden COVID-19-Beiträge 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. Angebotsbedingungen.

Methoden

create

 Erstellt einen neuen lokalen Beitrag, der mit dem angegebenen Standort verknüpft 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 für einen Standort zurück

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.