REST Resource: accounts.locations.media

Risorsa: MediaItem

Un singolo elemento multimediale.

Rappresentazione JSON 
{
  "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.
}
Campi
name

string

Il nome della risorsa per questo elemento multimediale. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Il formato di questo elemento multimediale. Deve essere impostato al momento della creazione dell'elemento multimediale ed è di sola lettura in tutte le altre richieste. Impossibile aggiornare.
locationAssociation

object (LocationAssociation)

Obbligatorio quando si chiama il numero CreatePhoto. Descrive il modo in cui questo elemento multimediale è collegato alla sua posizione. Deve essere una categoria (ad esempio ESTERNI) o l'ID di un elemento del listino prezzi.

Questa operazione è necessaria quando aggiungi nuovi contenuti multimediali a una posizione con media.create. Per altri tipi di contenuti multimediali, ad esempio le foto nei post locali, questo elemento non sarà presente.
googleUrl

string

Solo output. URL ospitato da Google per questo elemento multimediale. Questo URL non è statico, in quanto potrebbe cambiare nel tempo. Per i video, si tratta di un'immagine di anteprima con un'icona di riproduzione sovrapposta.
thumbnailUrl

string

Solo output. Se fornito, l'URL di un'immagine in miniatura per questo elemento multimediale.
createTime

string (Timestamp format)

Solo output. L'ora di creazione di questo elemento multimediale.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

Solo output. Le dimensioni (larghezza e altezza) in pixel.
insights

object (MediaInsights)

Solo output. Statistiche per questo elemento multimediale.
attribution

object (Attribution)

Solo output. Informazioni sull'attribuzione per gli elementi multimediali dei clienti. Devi mostrare questa attribuzione così come viene fornita ai tuoi utenti e non devi eliminarla o modificarla.
description

string

Descrizione di 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 unione data. L'origine dati dell'elemento multimediale. Quando crei un nuovo elemento multimediale, devi fornire un URL o un riferimento ai dati.

Ad eccezione delle categorie PROFILE e COVER, tutte le foto devono misurare almeno 250 px sul lato corto, con una dimensione del file di almeno 10240 byte.

Tutte le foto caricate devono rispettare le linee guida per le foto del profilo dell'attività. data può essere solo uno dei seguenti tipi:
sourceUrl

string

Un URL accessibile pubblicamente da cui è possibile recuperare l'elemento multimediale.

Quando ne crei uno, devi impostare questo o dataRef per specificare l'origine dell'elemento multimediale.

Se sourceUrl è stato utilizzato durante la creazione di un elemento multimediale, verrà compilato con l'URL di origine quando l'elemento multimediale viene recuperato.

Questo campo non può essere aggiornato.
dataRef

object (MediaItemDataRef)

Solo input. Un riferimento ai dati binari dell'elemento multimediale ottenuti con il metodo media.startUpload.

Quando crei un elemento multimediale,

sourceUrl

o

dataRef

deve essere impostato.

MediaItemDataRef

Riferimento ai dati binari della foto di un MediaItem caricato tramite l'API Google My Business.

Crea un riferimento ai dati utilizzando media.startUpload e utilizzalo quando carichi byte in [media.upload] e successivamente chiami media.create.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

L'ID univoco per i 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 questi byte con media.create.

Esempio di caricamento di byte: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Per le chiamate media.create, impostalo come MediaItem dataRef.

MediaFormat

Enumerazione 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

Come l'elemento multimediale è associato alla sua posizione.

Rappresentazione JSON 
{

  // 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.
}
Campi
Campo unione location_attachment_type. I contenuti multimediali della località devono avere una categoria o l'ID di un elemento del listino prezzi a cui sono associati. I contenuti multimediali non correlati alla posizione (ad esempio le foto dei post locali) non devono avere nessuno dei due. location_attachment_type può essere solo uno dei seguenti tipi:
category

enum (Category)

La categoria a cui appartiene questa foto della località.
priceListItemId

string

L'ID di un elemento del listino prezzi a cui è associata questa foto della sede.

Categoria

Enumerazione 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.
EXTERIOR Media esterni.
INTERIOR Contenuti multimediali interni.
PRODUCT Contenuti multimediali del prodotto.
AT_WORK Contenuti "sul lavoro".
FOOD_AND_DRINK Contenuti multimediali su cibi e bevande.
MENU Menu dei media.
COMMON_AREA Contenuti multimediali delle aree comuni.
ROOMS Contenuti multimediali delle stanze.
TEAMS Contenuti multimediali di Teams.
ADDITIONAL Altri contenuti multimediali senza categoria.

Dimensioni

Dimensioni dell'elemento multimediale.

Rappresentazione JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Campi
widthPixels

integer

Larghezza dell'elemento multimediale, in pixel.
heightPixels

integer

Altezza dell'elemento multimediale, in pixel.

MediaInsights

Approfondimenti e statistiche per l'elemento multimediale.

Rappresentazione JSON 
{
  "viewCount": string
}
Campi
viewCount

string (int64 format)

Solo output. Il numero di volte in cui l'elemento multimediale è stato visualizzato.

Attribuzione

Informazioni sull'attribuzione per gli 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

string

Il nome utente a cui attribuire l'elemento multimediale.
profilePhotoUrl

string

URL della miniatura della foto del profilo dell'utente attribuito.
takedownUrl

string

L'URL della pagina di rimozione, in cui l'elemento multimediale può essere segnalato se è inappropriato.
profileUrl

string

L'URL della pagina del profilo Google Maps dell'utente a cui è stata attribuita l'azione.

Metodi

create

 Crea un nuovo elemento multimediale per la posizione.

delete

 Elimina l'elemento multimediale specificato.

get

 Restituisce i metadati dell'elemento multimediale richiesto.

list

 Restituisce un elenco di elementi multimediali associati a una località.

patch

 Aggiorna i metadati dell'elemento multimediale specificato.

startUpload

 Genera un MediaItemDataRef per il caricamento degli elementi multimediali.