Ressource: MediaItem
Ein einzelnes Medienelement.
JSON-Darstellung | |
---|---|
{ "name": string, "mediaFormat": enum ( |
Felder | ||
---|---|---|
name |
Der Ressourcenname für dieses Medienelement. |
|
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 |
Erforderlich beim Aufrufen von Dies ist erforderlich, wenn einem Standort mit |
|
googleUrl |
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 |
Nur Ausgabe Sofern angegeben, die URL einer Miniaturansicht für dieses Medienelement. |
|
createTime |
Nur Ausgabe Erstellungszeit dieses Medienelements. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
|
dimensions |
Nur Ausgabe Die Abmessungen (Breite und Höhe) in Pixel. |
|
insights |
Nur Ausgabe Statistiken für dieses Medienelement |
|
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 |
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 Mit Ausnahme der Kategorien Alle hochgeladenen Fotos müssen den Richtlinien für Fotos in Unternehmensprofilen entsprechen. Für |
||
sourceUrl |
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 Dieses Feld kann nicht aktualisiert werden. |
|
dataRef |
Nur Eingabe. Ein Verweis auf die Binärdaten von Medienelementen, die von der Methode Beim Erstellen eines Medienelements muss entweder
oder
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 |
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 Beispiel für das Hochladen von Bytes: Legen Sie diese für |
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 |
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 |
Die Kategorie, zu der dieses Standortfoto gehört. |
|
priceListItemId |
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. |
LOGO |
Logobild. |
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 |
Breite des Medienelements in Pixeln |
heightPixels |
Höhe des Medienelements in Pixeln |
MediaInsights
Statistiken und Statistiken für das Medienelement
JSON-Darstellung | |
---|---|
{ "viewCount": string } |
Felder | |
---|---|
viewCount |
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 |
Der Nutzername, dem das Medienelement zugeordnet werden soll. |
profilePhotoUrl |
URL der Profilbild-Miniaturansicht des zugeordneten Nutzers. |
takedownUrl |
Die URL der Deaktivierungsseite, auf der das Medienelement gemeldet werden kann, falls es unangemessen ist. |
profileUrl |
Die URL der Google Maps-Profilseite des zugeordneten Nutzers. |
Methoden |
|
---|---|
|
Erstellt ein neues Medienelement für den Standort. |
|
Löscht das angegebene Medienelement. |
|
Gibt Metadaten für das angeforderte Medienelement zurück |
|
Gibt eine Liste von Medienelementen zurück, die einem Standort zugeordnet sind. |
|
Aktualisiert die Metadaten des angegebenen Medienelements. |
|
Erzeugt eine MediaItemDataRef für das Hochladen von Medienelementen. |