REST Resource: accounts.locations.media

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 au moins 250 pixels sur le bord court et 10 240 octets au minimum.

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.

MediaItemDataRef

Référence aux données binaires photo d'un MediaItem importé via l'API Google My Business.

Créez une référence de données à l'aide de media.startUpload, puis utilisez-la lors de l'importation d'octets dans [media.upload], puis lors de l'appel de media.create.

Représentation JSON 
{
  "resourceName": string
}
Champs
resourceName

string

Identifiant unique des données binaires de cet élément multimédia. Permet d'importer les données des photos avec [media.upload] et de créer un élément multimédia à partir de ces octets avec media.create.

Exemple d'importation d'octets: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Pour les appels media.create, définissez ce paramètre en tant que MediaItem dataRef.

MediaFormat

Énumération pour le format du média.

Enums
MEDIA_FORMAT_UNSPECIFIED Format non spécifié.
PHOTO L'élément multimédia est une photo. Dans cette version, seules les photos sont prises en charge.
VIDEO L'élément multimédia est une vidéo.

LocationAssociation

Association de l'élément multimédia à son emplacement.

Représentation 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.
}
Champs
Champ d'union location_attachment_type. L'élément multimédia de l'établissement doit être associé à une catégorie ou à l'ID d'un article de la liste de prix. Aucun des éléments multimédias qui ne sont pas associés à l'établissement (par exemple, des photos des posts locaux) ne doit comporter aucun de ces éléments. location_attachment_type ne peut être qu'un des éléments suivants :
category

enum (Category)

Catégorie à laquelle cette photo d'établissement appartient.
priceListItemId

string

Identifiant d'un article de la liste de prix auquel cette photo d'établissement est associée.

Catégorie

Énumération pour la catégorie d'élément multimédia.

Enums
CATEGORY_UNSPECIFIED Catégorie non spécifiée.
COVER Photo de couverture. Un établissement ne possède qu'une seule photo de couverture.
PROFILE Photo de profil. Un établissement ne peut avoir qu'une seule photo de profil.
EXTERIOR Support extérieur.
INTERIOR Éléments multimédias de l'intérieur.
PRODUCT Contenus multimédias du produit.
AT_WORK Au travail médias.
FOOD_AND_DRINK Élément multimédia représentant des aliments et des boissons.
MENU Contenu multimédia du menu.
COMMON_AREA Élément multimédia représentant les espaces communs.
ROOMS Contenu multimédia des salles.
TEAMS Éléments multimédias des équipes.
ADDITIONAL Contenus multimédias supplémentaires sans catégorie.

Dimensions

Dimensions de l'élément multimédia.

Représentation JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Champs
widthPixels

integer

Largeur de l'élément multimédia, en pixels.
heightPixels

integer

Hauteur de l'élément multimédia, en pixels.

MediaInsights

Insights et statistiques sur l'élément multimédia.

Représentation JSON 
{
  "viewCount": string
}
Champs
viewCount

string (int64 format)

Uniquement en sortie. Nombre de fois où l'élément multimédia a été vu.

Attribution

Informations d'attribution pour les éléments multimédias des clients, tels que le nom et la photo de profil du contributeur.

Représentation JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Champs
profileName

string

Nom d'utilisateur auquel attribuer l'élément multimédia.
profilePhotoUrl

string

URL de la vignette de la photo de profil de l'utilisateur attribué.
takedownUrl

string

URL de la page de retrait, où l'élément multimédia peut être signalé s'il est inapproprié.
profileUrl

string

URL de la page de profil Google Maps de l'utilisateur attribué.

Méthodes

create

 Crée un élément multimédia pour l'établissement.

delete

 Supprime l'élément multimédia spécifié.

get

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

list

 Affiche la liste des éléments multimédias associés à un établissement.

patch

 Met à jour les métadonnées de l'élément multimédia spécifié.

startUpload

 Génère un MediaItemDataRef pour l'importation de l'élément multimédia.