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

MediaItemDataRef

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

Erstellen Sie mit media.startUpload eine Datenreferenz und verwenden Sie diesen Verweis, 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 zum Hochladen der Fotodaten mit [media.upload] und beim Erstellen eines neuen Medienelements aus diesen Bytes mit media.create verwendet.

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 diese für media.create-Aufrufe 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

Gibt an, wie das Medienelement seinem Speicherort zugeordnet wird.

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. Nur ortsunabhängige Medien (z. B. Fotos von lokalen Beiträgen) dürfen keines der beiden Elemente 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 Außenmedien.
INTERIOR Medien „Innen“.
PRODUCT Produktmedien.
AT_WORK Medien für den Arbeitsalltag.
FOOD_AND_DRINK Medien zum Thema Essen und Trinken
MENU Menümedien.
COMMON_AREA Medien in Gemeinschaftsräumen.
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

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

Quellenangaben 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 Profilbild-Miniaturansicht des zugeordneten Nutzers.
takedownUrl

string

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

string

Die 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 einem Standort zugeordnet sind.

patch

 Aktualisiert die Metadaten des angegebenen Medienelements.

startUpload

 Erzeugt eine MediaItemDataRef für das Hochladen von Medienelementen.