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 requêtes. Ce paramètre ne peut pas être modifié.

locationAssociation

object (LocationAssociation)

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

Cette étape est obligatoire lorsque vous ajoutez des contenus multimédias à un établissement avec media.create. Pour les autres types de médias, tels que les photos sur les posts locaux, il 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 est susceptible de changer au fil du temps. Pour la vidéo, il s'agit d'un aperçu avec une icône de lecture superposée.

thumbnailUrl

string

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

createTime

string (Timestamp format)

Uniquement en sortie. Date et heure de création de cet élément multimédia.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. 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 des éléments multimédias des clients. Vous devez afficher cette mention 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. Vous ne pouvez pas modifier les descriptions 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 une référence de données.

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

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

sourceUrl

string

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

Lorsque vous créez l'un de ces éléments ou dataRef, vous devez définir 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.

Lorsque vous créez un élément multimédia,

sourceUrl

ou

dataRef

doit être définie.

Méthodes

get

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

list

Affiche la liste des éléments multimédias associés à un établissement auxquels ont contribué des clients.