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 für alle 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 Von 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 Nanosekundenauflösung 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 Pixel.

insights

object (MediaInsights)

Nur Ausgabe Statistiken für dieses Medienelement

attribution

object (Attribution)

Nur Ausgabe Quellenangabe für Medienelemente des Kunden. Diese Quellenangaben müssen so angezeigt werden, wie sie Ihren Nutzern bereitgestellt wurden. Sie dürfen die Quellenangabe 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 jedoch 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 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 Richtlinien für Fotos in Unternehmensprofilen entsprechen. Für data ist nur einer der folgenden Werte zulässig:

sourceUrl

string

Eine öffentlich zugängliche URL, über die das Medienelement abgerufen werden kann.

Beim Erstellen dieses Elements oder von dataRef muss die Quelle des Medienelements festgelegt werden.

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 von Medienelementen, die von der Methode media.startUpload abgerufen wurden.

Beim Erstellen eines Medienelements muss entweder

sourceUrl

oder

dataRef

festgelegt werden.

Methoden

get

Gibt Metadaten für das angeforderte Kundenmedienelement zurück

list

Gibt eine Liste der mit einem Standort verknüpften Medienelemente zurück, die von Kunden beigesteuert wurden.