REST Resource: accounts.locations.localPosts

Ressource: LocalPost

Ein lokaler Beitrag für einen Standort.

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

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der Beitragserstellung.

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)

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 sich der Beitrag befindet.
media[]

object (MediaItem)

Die mit dem Beitrag verknüpften Medien. „sourceUrl“ ist das einzige unterstützte Datenfeld für „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-Mail, 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 mit topicType-Benachrichtigungen und verhält sich als Untertyp von Benachrichtigungen.
offer

object (LocalPostOffer)

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

CallToAction

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 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 der Nutzer z. B. einen Termin reserviert.
ORDER Mit diesem Beitrag soll erreicht werden, dass der Nutzer etwas bestellt.
SHOP Mit diesem Beitrag soll erreicht werden, dass ein Nutzer einen Produktkatalog durchstöbert.
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 ein Nutzer registriert/registriert/für etwas beitritt.
GET_OFFER

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

LocalPostEvent

Alle Informationen zu einer Veranstaltung, die in einem lokalen Beitrag präsentiert wird

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

string

Name des Ereignisses.
schedule

object (TimeInterval)

Start- und Enddatum/-zeit des Ereignisses

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)

Der Beginn 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 Kein Status angegeben.
REJECTED Dieser Beitrag wurde aufgrund eines Verstoßes gegen die Inhaltsrichtlinien abgelehnt.
LIVE Dieser Beitrag ist veröffentlicht und erscheint derzeit in den Suchergebnissen.
PROCESSING Dieser Beitrag wird gerade 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 wie eine Zusammenfassung und Bilder.
EVENT Der Beitrag enthält allgemeine Informationen und einen Termin.
OFFER Beitrag enthält allgemeine Informationen sowie Inhalte zu Veranstaltungen und Angeboten (z.B. Gutscheincode)
ALERT Wichtige und aktuelle Ankündigungen zu einer laufenden Veranstaltung. Diese Arten von Beiträgen sind nicht immer zum Erstellen verfügbar.

AlertType

Der Ereignistyp, für den die Benachrichtigung erstellt wurde.

Enums
ALERT_TYPE_UNSPECIFIED Es wurde keine Benachrichtigung angegeben.
COVID_19 Warnungen im Zusammenhang mit der Coronapandemie 2019. COVID-19-Beiträge unterstützen nur eine Zusammenfassung und ein Call-to-Action-Feld. Wenn diese Benachrichtigungen nicht mehr relevant sind, wird die Erstellung neuer Benachrichtigungen für den Typ „COVID-19“ deaktiviert. Bestehende COVID-19-Beiträge können jedoch weiterhin verwaltet werden.

LocalPostOffer

Spezifische 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 des Angebots

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