REST Resource: accounts.locations.media.customers

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 bei allen anderen Anfragen schreibgeschützt. Aktualisierung nicht möglich.
locationAssociation

object (LocationAssociation)

Erforderlich beim Aufrufen von CreatePhoto. Beschreibt, wie dieses Medienelement mit seinem Speicherort verknüpft ist. Muss entweder eine Kategorie (z. B. EXTERIOR) oder die ID eines Preislistenelements sein.

Dies ist erforderlich, wenn einem Standort mit media.create neue Medien hinzugefügt werden. Bei anderen Medientypen, z. B. Fotos in lokalen Beiträgen, ist das nicht der Fall.
googleUrl

string

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

string

Nur Ausgabe. Sofern angegeben, die URL einer Miniaturansicht für dieses Medienelement.
createTime

string (Timestamp format)

Nur Ausgabe. Erstellungszeit 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. Attributionsinformationen für Medienelemente von Kunden. Sie müssen diese Quellenangaben so anzeigen, wie sie Ihren Nutzern zur Verfügung gestellt wurden, und dürfen die Quellenangabe nicht löschen oder verändern.
description

string

Beschreibung dieses Medienelements. Beschreibungen können nicht über die Google My Business API geändert werden. Sie können sie aber festlegen, wenn Sie ein neues Medienelement erstellen, das kein Titelbild ist.

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

Mit Ausnahme der Kategorien PROFILE und COVER müssen alle Fotos an der kurzen Seite mindestens 250 Pixel und eine Dateigröße von mindestens 10.240 Byte 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, unter der das Medienelement abgerufen werden kann.

Beim Erstellen einer dieser oder einer dataRef muss festgelegt werden, um die Quelle des Medienelements anzugeben.

Wenn sourceUrl 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 der Medienelemente, wie sie über die Methode media.startUpload abgerufen wurden.

Beim Erstellen eines Medienelements

sourceUrl

oder

dataRef

festgelegt werden muss.

Methoden

get

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

list

 Gibt eine Liste von Medienelementen zurück, die einem Standort zugeordnet sind und von Kunden beigesteuert wurden.