REST Resource: accounts.locations.media

Ressource: MediaItem

Ein einzelnes Medienelement.

JSON-Darstellung 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
Felder
name

string

Der Ressourcenname für dieses Medienelement. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Das Format dieses Medienelements. Muss beim Erstellen des Medienelements festgelegt werden und ist für alle anderen Anfragen schreibgeschützt. Aktualisierung nicht möglich.
locationAssociation

object (LocationAssociation)

Erforderlich beim Aufrufen von CreatePhoto. Beschreibt, wie dieses Medienelement mit dem Speicherort verbunden ist. Muss entweder eine Kategorie (z. B. EXTERIOR) oder die ID eines Artikels auf einer Preisliste sein.

Das ist erforderlich, wenn einem Standort mit media.create neue Medien hinzugefügt werden. Für andere Medientypen, z. B. Fotos für lokale Beiträge, ist das nicht möglich.
googleUrl

string

Nur Ausgabe. Von Google gehostete URL für dieses Medienelement. Diese URL ist nicht statisch, weil sie sich im Laufe der Zeit ändern kann. Bei Videos ist das ein Vorschaubild mit einem eingeblendeten Wiedergabesymbol.
thumbnailUrl

string

Nur Ausgabe. Gegebenenfalls die URL einer Miniaturansicht für dieses Medienelement.
createTime

string (Timestamp format)

Nur Ausgabe. Erstellungszeitpunkt dieses Medienelements.

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".
dimensions

object (Dimensions)

Nur Ausgabe. Die Abmessungen (Breite und Höhe) in Pixeln.
insights

object (MediaInsights)

Nur Ausgabe. Statistiken für dieses Medienelement.
attribution

object (Attribution)

Nur Ausgabe. Quellenangabe für Medienelemente von Kunden. Sie müssen diese Quellenangabe Ihren Nutzern wie angegeben präsentieren und dürfen sie weder löschen noch verändern.
description

string

Beschreibung für dieses Medienelement. Beschreibungen können nicht über die Google My Business API geändert werden. Sie können aber beim Erstellen eines neuen Medienelements, das kein Titelbild ist, festgelegt werden.

Union-Feld data. Die Datenquelle des Medienelements. Beim Erstellen eines neuen Medienelements muss entweder eine URL oder eine Datenreferenz angegeben werden.

Mit Ausnahme der Kategorie PROFILE und COVER müssen alle Fotos an der Schmalseite mindestens 250 Pixel und eine Dateigröße von mindestens 10.240 Bytes haben.

Alle hochgeladenen Fotos müssen den Fotorichtlinien für Unternehmensprofile entsprechen. Für data ist nur einer der folgenden Werte zulässig:
sourceUrl

string

Eine öffentlich zugängliche URL, von der das Medienelement abgerufen werden kann.

Wenn Sie einen dieser Parameter oder dataRef erstellen, muss die Quelle des Medienelements festgelegt werden.

Wenn das sourceUrl-Element beim Erstellen eines Medienelements verwendet wurde, wird es beim Abrufen des Medienelements mit dieser Quell-URL gefüllt.

Dieses Feld kann nicht aktualisiert werden.
dataRef

object (MediaItemDataRef)

Nur Eingabe. Ein Verweis auf die Binärdaten des Medienelements, wie er von der Methode media.startUpload abgerufen wurde.

Beim Erstellen eines Medienelements muss entweder

sourceUrl

oder

dataRef

muss festgelegt werden.

MediaItemDataRef

Verweis auf die Binärdaten eines Fotos von MediaItem, die über die Google My Business API hochgeladen wurden.

Erstellen Sie mit media.startUpload einen Datenverweis und verwenden Sie ihn beim Hochladen von Bytes in [media.upload] und dem anschließenden Aufrufen von media.create.

JSON-Darstellung 
{
  "resourceName": string
}
Felder
resourceName

string

Die eindeutige ID für die Binärdaten dieses Medienelements. Dient zum Hochladen der Fotodaten mit [media.upload] und beim Erstellen eines neuen Medienelements aus diesen Bytes mit media.create.

Beispiel für das Hochladen von Bytes: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Legen Sie für media.create-Aufrufe diesen Wert als MediaItem dataRef fest.

MediaFormat

Aufzählung für Medienformat

Enums
MEDIA_FORMAT_UNSPECIFIED Format nicht angegeben.
PHOTO Das Medienelement ist ein Foto. In dieser Version werden nur Fotos unterstützt.
VIDEO Das Medienelement ist ein Video.

LocationAssociation

Zuordnung des Medienelements zum Standort.

JSON-Darstellung 
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
Felder
Union-Feld location_attachment_type. Standortmedien müssen entweder eine Kategorie oder die ID eines Preislistenelements haben, mit dem sie verknüpft sind. Andere Arten von Medien (z. B. Fotos für lokale Beiträge) dürfen nicht vorhanden sein. Für location_attachment_type ist nur einer der folgenden Werte zulässig:
category

enum (Category)

Die Kategorie, zu der dieses Standortfoto gehört
priceListItemId

string

Die ID eines Preislistenelements, mit dem dieses Standortfoto verknüpft ist.

Kategorie

Aufzählung für Medienelementkategorie

Enums
CATEGORY_UNSPECIFIED Kategorie nicht angegeben.
COVER Titelbild. Ein Standort hat nur ein Titelbild.
PROFILE Profilbild Ein Standort hat nur ein Profilbild.
EXTERIOR Medien „Außenaufnahmen“
INTERIOR Medien „Innenaufnahmen“
PRODUCT Produktmedien.
AT_WORK Medien „Am Arbeitsplatz“
FOOD_AND_DRINK Medien zum Thema Essen und Trinken.
MENU Medien „Speisekarte“
COMMON_AREA Medien „Gemeinschaftsräume“
ROOMS Medien „Räume“
TEAMS Teams-Medien.
ADDITIONAL Zusätzliche, nicht kategorisierte Medien.

Abmessungen

Abmessungen des Medienelements.

JSON-Darstellung 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Felder
widthPixels

integer

Breite des Medienelements in Pixeln
heightPixels

integer

Höhe des Medienelements in Pixeln

MediaInsights

Einblicke und Statistiken für das Medienelement

JSON-Darstellung 
{
  "viewCount": string
}
Felder
viewCount

string (int64 format)

Nur Ausgabe. Gibt an, wie oft das Medienelement aufgerufen wurde.

Attribution

Quellenangabe für Medienelemente von Kunden, z. B. Name und Profilbild des Mitwirkenden

JSON-Darstellung 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Felder
profileName

string

Der Nutzername für die Quellenangabe des Medienelements
profilePhotoUrl

string

URL des Profilbilds des zugeordneten Nutzers
takedownUrl

string

Die URL der Deaktivierungsseite, über die das Medienelement gemeldet werden kann, wenn es unangemessen ist
profileUrl

string

URL der Google Maps-Profilseite des zugeordneten Nutzers

Methoden

create

 Erstellt ein neues Media-Element für den Standort.

delete

 Löscht das angegebene Medienelement.

get

 Gibt Metadaten für das angeforderte Medienelement zurück.

list

 Gibt eine Liste der Medienelemente zurück, die mit einem Standort verknüpft sind.

patch

 Aktualisiert die Metadaten des angegebenen Medienelements.

startUpload

 Generiert ein MediaItemDataRef für das Hochladen von Medienelementen.