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

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

enum (MediaFormat)

Es el formato de este elemento multimedia. Se debe configurar cuando se crea el elemento multimedia y es de solo lectura en todas las demás solicitudes. No se puede actualizar.
locationAssociation

object (LocationAssociation)

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. En el caso de otros tipos de contenido multimedia, por ejemplo, las fotos en las publicaciones locales, no se mostrará.
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. En el caso de los videos, será una imagen de vista previa 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. Es la hora de creación de este elemento multimedia.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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. Son las 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 a través de la API de Google My Business, pero se pueden establecer 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. Cuando se crea un elemento multimedia nuevo, se debe proporcionar una URL o una referencia de datos.

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

Todas las fotos subidas deben cumplir con los lineamientos de los Perfiles de Negocio para las fotos. data puede ser solo uno de los parámetros siguientes:
sourceUrl

string

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

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

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

Este campo no se puede actualizar.
dataRef

object (MediaItemDataRef)

Solo entrada. Es una referencia a los datos binarios del elemento multimedia, como se obtienen con el método media.startUpload.

Cuando crees un elemento multimedia, haz una de las siguientes acciones:

sourceUrl

o

dataRef

se debe establecer.

MediaItemDataRef

Es una referencia a los datos binarios de la foto de un objeto MediaItem que se subió a través de la API de Google My Business.

Crea una referencia de datos con media.startUpload y usa esta referencia 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 elemento multimedia nuevo 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 a media.create, establece este valor como el MediaItem dataRef.

MediaFormat

Es la enumeración del formato de medios.

Enums
MEDIA_FORMAT_UNSPECIFIED Formato sin especificar.
PHOTO El elemento multimedia es una foto. En esta versión, solo se admiten fotos.
VIDEO El elemento multimedia es un video.

LocationAssociation

Es la forma en que el elemento multimedia se asocia 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. El contenido multimedia de ubicación debe tener una categoría o el ID de un elemento de la lista de precios con el que esté asociado. Los medios que no son de ubicación (por ejemplo, las fotos de publicaciones locales) no deben tener ninguno de los dos. location_attachment_type puede ser solo uno de los parámetros siguientes:
category

enum (Category)

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

string

Es el ID de un elemento de lista de precios con el que se asocia esta foto de ubicación.

Categoría

Es un enum para la categoría de elemento multimedia.

Enums
CATEGORY_UNSPECIFIED Categoría no especificada.
COVER Foto de portada. Una ubicación solo tiene una foto de portada.
PROFILE Foto de perfil Una ubicación solo tiene una foto de perfil.
EXTERIOR Medios exteriores
INTERIOR Son los medios interiores.
PRODUCT Es el contenido multimedia del producto.
AT_WORK Medios de "en el trabajo"
FOOD_AND_DRINK Contenido multimedia de comida y bebida
MENU Es el contenido multimedia del menú.
COMMON_AREA Multimedia de áreas comunes
ROOMS Es el contenido multimedia de las salas.
TEAMS Contenido multimedia de Teams
ADDITIONAL Es contenido multimedia adicional sin categorizar.

Dimensiones

Son las dimensiones del elemento multimedia.

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

integer

Ancho del elemento multimedia, en píxeles.
heightPixels

integer

Altura del elemento multimedia, en píxeles.

MediaInsights

Son las estadísticas y las métricas de la publicación.

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

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

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

string

Es la URL de la página del perfil de Google Maps del usuario al que se atribuye la opinión.

Métodos

create

 Crea un elemento multimedia nuevo para la ubicación.

delete

 Borra el elemento multimedia especificado.

get

 Devuelve los metadatos del elemento multimedia solicitado.

list

 Devuelve una lista de elementos multimedia asociados a una ubicación.

patch

 Actualiza los metadatos del elemento multimedia especificado.

startUpload

 Genera un objeto MediaItemDataRef para la carga de elementos multimedia.