REST Resource: accounts.locations.media

Recurso: MediaItem

Es un solo elemento multimedia.

Representación 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.
}
Campos
name

string

El nombre de recurso de este elemento multimedia. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Es el formato de este elemento multimedia. Debe configurarse cuando se crea el elemento multimedia. Es de solo lectura en todas las demás solicitudes. No se puede actualizar.
locationAssociation

object (LocationAssociation)

Es obligatorio cuando se llama a CreatePhoto. Describe cómo se conecta este elemento multimedia con su ubicación. Debe ser una categoría (por ejemplo, EXTERIOR) o el ID de un elemento de la lista de precios.

Esto es obligatorio cuando se agrega contenido multimedia nuevo a una ubicación con media.create. La opción no estará presente en otros tipos de contenido multimedia, como fotos en publicaciones locales.
googleUrl

string

Solo salida. Es la URL alojada en Google para este elemento multimedia. Esta URL no es estática, ya que puede cambiar con el tiempo. Para los videos, se trata de una vista previa de la imagen con un ícono de reproducción superpuesto.
thumbnailUrl

string

Solo salida. Cuando se proporciona, es la URL de una imagen en miniatura de este elemento multimedia.
createTime

string (Timestamp format)

Solo salida. Hora de creación de este elemento multimedia.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

Solo salida. Son las dimensiones (ancho y alto) en píxeles.
insights

object (MediaInsights)

Solo salida. Estadísticas de este elemento multimedia.
attribution

object (Attribution)

Solo salida. Es la información de atribución de los elementos multimedia del cliente. Debes mostrar esta atribución tal como se proporciona a tus usuarios y no debes borrarla ni alterarla.
description

string

Es la descripción de este elemento multimedia. Las descripciones no se pueden modificar mediante la API de Google My Business, pero se pueden configurar cuando se crea un elemento multimedia nuevo que no sea una foto de portada.

Campo de unión data. Es la fuente de datos del elemento multimedia. Al crear un nuevo elemento multimedia, se debe proporcionar una URL o una referencia de datos.

A excepción de las categorías PROFILE y COVER, todas las fotos deben medir un mínimo de 250 px en el borde corto y un tamaño de archivo de al menos 10, 240 bytes.

Todas las fotos subidas deben seguir los lineamientos del Perfil de Negocio para las fotos. Las direcciones (data) solo pueden ser una de las siguientes opciones:
sourceUrl

string

Una URL de acceso público desde la que se puede recuperar el elemento multimedia.

Cuando se crea uno de estos elementos o se debe establecer dataRef para especificar la fuente del elemento multimedia

Si se usó sourceUrl cuando se creaba un elemento multimedia, se propagará con esa URL de origen cuando se recupere el elemento multimedia.

No se puede actualizar este campo.
dataRef

object (MediaItemDataRef)

Solo entrada. Es una referencia a datos binarios de elementos multimedia obtenidos con el método media.startUpload.

Cuando crees un elemento multimedia,

sourceUrl

o

dataRef

.

MediaItemDataRef

Referencia a los datos binarios de fotos de un objeto MediaItem subido a través de la API de Google My Business.

Crea una referencia de datos con media.startUpload y úsala cuando subas bytes a [media.upload] y, luego, llames a media.create.

Representación JSON 
{
  "resourceName": string
}
Campos
resourceName

string

Es el ID único de los datos binarios de este elemento multimedia. Se usa para subir los datos de la foto con [media.upload] y cuando se crea un nuevo elemento multimedia a partir de esos bytes con media.create.

Ejemplo de carga de bytes: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Para las llamadas de media.create, establece esto como MediaItem dataRef.

MediaFormat

Es una enumeración para el formato de medios.

Enumeradores
MEDIA_FORMAT_UNSPECIFIED Formato no especificado.
PHOTO El elemento multimedia es una foto. En esta versión, solo se admiten fotos.
VIDEO El elemento multimedia es un video.

LocationAssociation

Indica cómo se asocia el elemento multimedia con su ubicación.

Representación 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.
}
Campos
Campo de unión location_attachment_type. Los medios de ubicación deben tener una categoría o el ID de un elemento de la lista de precios con el que estén asociados. Los medios que no sean relacionados con la ubicación (por ejemplo, fotos de publicaciones locales) no deben incluir ninguno de estos elementos. Las direcciones (location_attachment_type) solo pueden ser una de las siguientes opciones:
category

enum (Category)

La categoría a la que pertenece esta foto de ubicación.
priceListItemId

string

El ID de un elemento de la lista de precios con el que está asociada esta foto de ubicación.

Categoría

Enumeración para la categoría del elemento multimedia.

Enumeradores
CATEGORY_UNSPECIFIED Categoría sin especificar.
COVER Foto de portada Una ubicación tiene solo una foto de portada.
PROFILE Foto de perfil Una ubicación solo tiene una foto de perfil.
EXTERIOR Contenido multimedia exterior.
INTERIOR Contenido multimedia de interiores
PRODUCT Contenido multimedia del producto.
AT_WORK Contenido multimedia "en el trabajo"
FOOD_AND_DRINK Medios de comida y bebidas.
MENU Contenido multimedia del menú
COMMON_AREA Contenido multimedia de áreas comunes
ROOMS Contenido multimedia de las salas.
TEAMS Equipos multimedia
ADDITIONAL Contenido multimedia adicional sin clasificar

Dimensiones

Dimensiones del elemento multimedia.

Representación JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Campos
widthPixels

integer

Es el ancho del elemento multimedia en píxeles.
heightPixels

integer

Es la altura del elemento multimedia en píxeles.

MediaInsights

Estadísticas y estadísticas para el elemento multimedia.

Representación JSON 
{
  "viewCount": string
}
Campos
viewCount

string (int64 format)

Solo salida. Indica la cantidad de veces que se vio el elemento multimedia.

Atribución

Es la información de atribución de los elementos multimedia del cliente, como el nombre y la foto de perfil del colaborador.

Representación JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Campos
profileName

string

El nombre de usuario al que se atribuirá el elemento multimedia.
profilePhotoUrl

string

URL de la miniatura de la foto de perfil del usuario atribuido.
takedownUrl

string

La URL de la página de eliminación, en la que se puede denunciar el elemento multimedia si es inapropiado.
profileUrl

string

La URL de la página de perfil de Google Maps del usuario atribuido.

Métodos

create

 Crea un nuevo elemento multimedia para la ubicación.

delete

 Borra el elemento multimedia especificado.

get

 Muestra metadatos para el elemento multimedia solicitado.

list

 Muestra una lista de elementos multimedia asociados con una ubicación.

patch

 Actualiza los metadatos del elemento multimedia especificado.

startUpload

 Genera un MediaItemDataRef para la carga de elementos multimedia.