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 del recurso para este elemento multimedia. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Es el formato de este elemento multimedia. Se debe establecer cuando se crea el elemento multimedia y 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 este elemento multimedia está conectado con su ubicación. Debe ser una categoría (por ejemplo, EXTERIOR) o el ID de un elemento de la lista de precios.

Esta acción es obligatoria cuando se agrega contenido multimedia nuevo a una ubicación con media.create. En el caso de otros tipos de contenido multimedia, como las fotos en publicaciones locales, esta información 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. Para los videos, esta 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 para 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 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. Estadísticas de este elemento multimedia.
attribution

object (Attribution)

Solo salida. Información de atribución para elementos multimedia del cliente. Debe mostrar esta atribución tal como se proporcionó a sus usuarios y no debe borrarla ni alterarla.
description

string

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 configurar al crear un nuevo elemento multimedia que no sea una foto de portada.

Campo de unión data. La fuente de datos del elemento multimedia. Cuando se crea 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 del archivo de al menos 10, 240 bytes.

Todas las fotos subidas deben cumplir con los lineamientos del Perfil de Negocio relacionados con 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 creó 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 los datos binarios del elemento multimedia, tal como se obtiene con el método media.startUpload.

Cuando se crea un elemento multimedia,

sourceUrl

o

dataRef

que se debe configurar.

MediaItemDataRef

Referencia a los datos binarios de las fotos de un objeto MediaItem que se subió a través de la API de Google Mi Negocio

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 fotos 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 media.create, establece esto como MediaItem dataRef.

MediaFormat

Es una enumeración para el formato multimedia.

Enumeraciones
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

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. El contenido multimedia que no se relacione con la ubicación (por ejemplo, las fotos de publicaciones locales) no debe tener ninguna de estas características. 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

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

Categoría

Es una enumeración para la categoría de elemento multimedia.

Enumeraciones
CATEGORY_UNSPECIFIED Categoría no especificada.
COVER Foto de portada. Una ubicación tiene solo una foto de portada.
PROFILE Foto de perfil Una ubicación tiene solo una foto de perfil.
EXTERIOR Medios exteriores
INTERIOR Contenido multimedia de interiores.
PRODUCT Medios de productos
AT_WORK “En el trabajo” medios de comunicación.
FOOD_AND_DRINK Medios de comunicación sobre comidas y bebidas.
MENU Contenido multimedia del menú
COMMON_AREA Medios de área común.
ROOMS Contenido multimedia de las salas.
TEAMS Equipos de medios.
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

Altura del elemento multimedia, en píxeles.

MediaInsights

Estadísticas y estadísticas del 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

Información de atribución para 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

Es 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

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 los metadatos del 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 subir elementos multimedia.