REST Resource: accounts.locations.media.customers

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 impostata al momento della creazione dell'elemento multimediale ed è di sola lettura in tutte le altre richieste. Impossibile aggiornare.

locationAssociation

object (LocationAssociation)

Obbligatorio quando chiami CreatePhoto. Descrive come questo elemento multimediale è collegato alla sua posizione. Deve essere una categoria (ad es. EXTERIOR) o l'ID di un elemento del listino prezzi.

Questo valore è obbligatorio quando aggiungi nuovi contenuti multimediali a una stazione di ricarica con media.create. Per altri tipi di contenuti multimediali, ad esempio le foto nei post locali, non sarà presente.

googleUrl

string

Solo output. URL ospitato da Google per questo elemento multimediale. Questo URL non è statico poiché potrebbe cambiare nel tempo. Per i video sarà 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. Ora di creazione di questo elemento multimediale.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di 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 del cliente. Devi mostrare questa attribuzione come fornita agli 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 quando viene creato un nuovo elemento multimediale che non è 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 dati.

Ad eccezione della categoria PROFILE e COVER, tutte le foto devono misurare almeno 250 pixel sul lato corto e avere una dimensione del file di almeno 10240 byte.

Tutte le foto caricate devono rispettare le linee guida di Profilo dell'attività per le foto. data può essere solo uno dei seguenti:

sourceUrl

string

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

Quando si crea questo elemento, o dataRef deve essere impostato 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 viene recuperato l'elemento multimediale.

Questo campo non può essere aggiornato.

dataRef

object (MediaItemDataRef)

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

Quando crei un elemento multimediale,

sourceUrl

o

dataRef

deve essere impostato.

Metodi

get

Restituisce i metadati dell'elemento multimediale del cliente richiesto.

list

Restituisce un elenco di elementi multimediali associati a una località che sono stati forniti dai clienti.