Risorsa: MediaItem
Un singolo elemento multimediale.
Rappresentazione JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
Campi | ||
---|---|---|
name |
Il nome della risorsa per questo elemento multimediale. |
|
mediaFormat |
Il formato di questo elemento multimediale. Deve essere impostato al momento della creazione dell'elemento multimediale ed è di sola lettura per tutte le altre richieste. Impossibile aggiornare. |
|
locationAssociation |
Obbligatorio per la chiamata al numero Questa operazione è necessaria quando aggiungi nuovi contenuti multimediali a una posizione con |
|
googleUrl |
Solo output. URL ospitato da Google per questo elemento multimediale. Questo URL non è statico perché potrebbe cambiare nel tempo. Per i video sarà un'immagine di anteprima con un'icona di riproduzione sovrapposta. |
|
thumbnailUrl |
Solo output. Se fornito, l'URL di un'immagine in miniatura per questo elemento multimediale. |
|
createTime |
Solo output. Data/ora di creazione di questo elemento multimediale. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
|
dimensions |
Solo output. Le dimensioni (larghezza e altezza) in pixel. |
|
insights |
Solo output. Statistiche per questo elemento multimediale. |
|
attribution |
Solo output. Informazioni sull'attribuzione per gli elementi multimediali dei clienti. Devi mostrare questa attribuzione come fornita agli utenti e non devi eliminarla o alterare l'attribuzione. |
|
description |
Descrizione per questo elemento multimediale. Le descrizioni non possono essere modificate tramite l'API Google My Business, ma possono essere impostate durante la creazione di un nuovo elemento multimediale che non sia una foto di copertina. |
|
Campo di unione Ad eccezione delle categorie Tutte le foto caricate devono rispettare le linee guida di Profilo dell'attività per le foto. |
||
sourceUrl |
Un URL accessibile pubblicamente da cui è possibile recuperare l'elemento multimediale. Quando crei un elemento o dataRef, devi impostare l'origine per specificare l'origine dell'elemento multimediale. Se Questo campo non può essere aggiornato. |
|
dataRef |
Solo input. Un riferimento ai dati binari degli elementi multimediali ottenuti dal metodo Quando crei un elemento multimediale,
o
deve essere impostato. |
MediaItemDataRef
Riferimento ai dati binari delle foto di un MediaItem
caricati tramite l'API Google My Business.
Crea un riferimento dati utilizzando media.startUpload
e utilizzalo quando carichi i byte in [media.upload] e chiami successivamente media.create
.
Rappresentazione JSON | |
---|---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
L'ID univoco dei dati binari di questo elemento multimediale. Utilizzato per caricare i dati delle foto con [media.upload] e durante la creazione di un nuovo elemento multimediale da quei byte con Esempio di caricamento dei byte: Per le chiamate |
MediaFormat
Enum per il formato multimediale.
Enum | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
Formato non specificato. |
PHOTO |
L'elemento multimediale è una foto. In questa versione sono supportate solo le foto. |
VIDEO |
L'elemento multimediale è un video. |
LocationAssociation
Modalità di associazione dell'elemento multimediale alla sua posizione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di unione location_attachment_type . I contenuti multimediali della posizione devono avere una categoria o l'ID di un elemento di listino a cui sono associati. I contenuti multimediali diversi dalla posizione (ad esempio le foto di post locali) non devono avere nessuno dei due. location_attachment_type può essere solo uno dei seguenti: |
||
category |
La categoria a cui appartiene questa foto della posizione. |
|
priceListItemId |
L'ID di un elemento di listino a cui è associata questa foto della sede. |
Categoria
Enum per la categoria dell'elemento multimediale.
Enum | |
---|---|
CATEGORY_UNSPECIFIED |
Categoria non specificata. |
COVER |
Foto di copertina. Una sede ha una sola foto di copertina. |
PROFILE |
Foto del profilo. Una sede ha una sola foto del profilo. |
LOGO |
Foto del logo. |
EXTERIOR |
Contenuti multimediali esterni. |
INTERIOR |
Contenuti multimediali interni. |
PRODUCT |
Contenuti multimediali del prodotto. |
AT_WORK |
"Durante il lavoro". |
FOOD_AND_DRINK |
Contenuti multimediali relativi ad alimenti e bevande. |
MENU |
Contenuti multimediali del menu. |
COMMON_AREA |
Contenuti multimediali dell'area comune. |
ROOMS |
Contenuti multimediali delle stanze. |
TEAMS |
Contenuti multimediali dei team. |
ADDITIONAL |
Contenuti multimediali aggiuntivi senza categoria. |
Dimensioni
Dimensioni dell'elemento multimediale.
Rappresentazione JSON | |
---|---|
{ "widthPixels": integer, "heightPixels": integer } |
Campi | |
---|---|
widthPixels |
Larghezza dell'elemento multimediale, in pixel. |
heightPixels |
Altezza dell'elemento multimediale, in pixel. |
MediaInsights
Approfondimenti e statistiche per l'elemento multimediale.
Rappresentazione JSON | |
---|---|
{ "viewCount": string } |
Campi | |
---|---|
viewCount |
Solo output. Il numero di volte in cui l'elemento multimediale è stato visualizzato. |
Attribuzione
Informazioni sull'attribuzione degli elementi multimediali dei clienti, ad esempio il nome e l'immagine del profilo del collaboratore.
Rappresentazione JSON | |
---|---|
{ "profileName": string, "profilePhotoUrl": string, "takedownUrl": string, "profileUrl": string } |
Campi | |
---|---|
profileName |
Il nome utente a cui attribuire l'elemento multimediale. |
profilePhotoUrl |
URL della miniatura della foto del profilo dell'utente attribuito. |
takedownUrl |
L'URL della pagina di rimozione, in cui l'elemento multimediale può essere segnalato se non è appropriato. |
profileUrl |
L'URL della pagina del profilo Google Maps dell'utente attribuito. |
Metodi |
|
---|---|
|
Crea un nuovo elemento multimediale per la posizione. |
|
Elimina l'elemento multimediale specificato. |
|
Restituisce i metadati per l'elemento multimediale richiesto. |
|
Restituisce un elenco di elementi multimediali associati a una posizione. |
|
Consente di aggiornare i metadati dell'elemento multimediale specificato. |
|
Genera un valore MediaItemDataRef per il caricamento dell'elemento multimediale. |