REST Resource: accounts.locations.media.customers

Ressource: MediaItem

Un seul élément multimédia.

Représentation 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.
}
Champs
name

string

Nom de ressource de cet élément multimédia. accounts/{accountId}/locations/{locationId}/media/{mediaKey}

mediaFormat

enum (MediaFormat)

Format de cet élément multimédia. Doit être défini lors de la création de l'élément multimédia et est en lecture seule pour toutes les autres demandes. Ce paramètre ne peut pas être modifié.

locationAssociation

object (LocationAssociation)

Obligatoire lors de l'appel de CreatePhoto. Décrit comment cet élément multimédia est associé à son emplacement. Doit être une catégorie (par exemple, EXTERIOR) ou l'identifiant d'un article de la liste de prix.

Nécessaire lorsque vous ajoutez des contenus multimédias à un emplacement avec media.create. Pour les autres types de médias, tels que les photos sur les posts locaux, cette option ne sera pas disponible.

googleUrl

string

Uniquement en sortie. URL hébergée par Google pour cet élément multimédia. Cette URL n'est pas statique, car elle peut changer au fil du temps. Pour les vidéos, il s'agit d'un aperçu avec une icône de lecture superposée.

thumbnailUrl

string

Uniquement en sortie. URL de la vignette de cet élément multimédia, si elle est fournie.

createTime

string (Timestamp format)

Uniquement en sortie. Heure de création de cet élément multimédia.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

dimensions

object (Dimensions)

Uniquement en sortie. Dimensions (largeur et hauteur) en pixels.

insights

object (MediaInsights)

Uniquement en sortie. Statistiques sur cet élément multimédia.

attribution

object (Attribution)

Uniquement en sortie. Informations sur l'attribution pour les éléments multimédias des clients. Vous devez afficher cette attribution telle qu'elle a été fournie à vos utilisateurs, et vous ne devez pas la supprimer ni la modifier.

description

string

Description de cet élément multimédia. Les descriptions ne peuvent pas être modifiées via l'API Google My Business, mais vous pouvez les définir lors de la création d'un élément multimédia autre que la photo de couverture.

Champ d'union data. Source de données de l'élément multimédia. Lorsque vous créez un élément multimédia, vous devez fournir une URL ou des références de données.

À l'exception des catégories PROFILE et COVER, toutes les photos doivent mesurer un minimum de 250 pixels sur le bord court et une taille de fichier d'au moins 10 240 octets.

Toutes les photos importées doivent respecter les Consignes concernant les photos des fiches d'établissement. data ne peut être qu'un des éléments suivants :

sourceUrl

string

URL accessible publiquement à partir de laquelle l'élément multimédia peut être récupéré.

Lors de la création de l'une de ces valeurs, vous devez définir dataRef pour spécifier la source de l'élément multimédia.

Si sourceUrl a été utilisé lors de la création d'un élément multimédia, il sera renseigné avec cette URL source lors de la récupération de l'élément multimédia.

Impossible de mettre à jour ce champ.

dataRef

object (MediaItemDataRef)

Uniquement en entrée. Référence aux données binaires de l'élément multimédia obtenues par la méthode media.startUpload.

Lors de la création d'un élément multimédia,

sourceUrl

ou

dataRef

doit être défini.

Méthodes

get

Affiche les métadonnées de l'élément multimédia client demandé.

list

Affiche une liste d'éléments multimédias associés à un établissement dont les clients ont contribué.