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

MediaItemDataRef

Verweis auf die binären Fotodaten einer MediaItem, die über die Google My Business API hochgeladen wurde

Erstellen Sie mit media.startUpload eine Datenreferenz und verwenden Sie diese Referenz, wenn Sie Bytes in [media.upload] hochladen und anschließend media.create aufrufen.

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

string

Die eindeutige ID für die Binärdaten dieses Medienelements. Wird verwendet, um die Fotodaten mit [media.upload] hochzuladen und ein neues Medienelement aus diesen Bytes mit media.create zu erstellen.

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 dies für media.create-Aufrufe als MediaItem dataRef fest.

MediaFormat

Aufzählung für das Medienformat.

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

LocationAssociation

Gibt an, wie das Medienelement mit seinem Standort verknüpft ist.

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. Nicht zum Standort gehörende Medien (z. B. Fotos von lokalen Beiträgen) dürfen keines von beiden enthalten. 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 im Außenbereich.
INTERIOR Medien im Innenbereich.
PRODUCT Produktmedien.
AT_WORK „Am Arbeitsplatz“ Medien.
FOOD_AND_DRINK Medien „Essen und Trinken“
MENU Menümedien.
COMMON_AREA Medien in Gemeinschaftsräumen.
ROOMS Medien in Räumen.
TEAMS Teammedien.
ADDITIONAL Zusätzliche, nicht kategorisierte Medien.

Dimensionen

Größe 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

Statistiken 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

Attributionsinformationen für Kundenmedienelemente, z. B. Name und Profilbild des Mitwirkenden

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

string

Der Nutzername, dem das Medienelement zugeordnet werden soll.
profilePhotoUrl

string

URL der Miniaturansicht des Profilbilds des zugeordneten Nutzers.
takedownUrl

string

Die URL der Deaktivierungsseite, auf der das Medienelement gemeldet werden kann, wenn es unangemessen ist.
profileUrl

string

URL der Google Maps-Profilseite des zugeordneten Nutzers

Methoden

create

 Erstellt ein neues Medienelement für den Standort.

delete

 Löscht das angegebene Medienelement

get

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

list

 Gibt eine Liste von Medienelementen zurück, die mit einem Standort verknüpft sind.

patch

 Aktualisiert die Metadaten des angegebenen Medienelements.

startUpload

 Generiert eine MediaItemDataRef für das Hochladen von Medienelementen.